Linux 命令详解：whoami 打印当前有效用户 ID 对应的名称（linux-command 手册解析）

• 文档
• 教程

whoami是 GNU coreutils 包中一个看似简单却极其常用的命令，用于打印当前有效用户 ID 对应的用户名。本篇文章以 linux-command 仓库中 command/whoami.md 文档为骨架，结合仓库内 command/id.md、command/logname.md、command/who.md 等相邻命令文档与 README.md 中的项目说明，完整讲解whoami的用法、选项、返回值、与logname、id的差异，以及如何在本仓库的 Web 版与 npm 包中检索、引用该命令手册，读完即可在实战中准确判断"当前我是谁"。

概要

whoami [OPTION]...

whoami不需要任何必选参数，只接收可选的OPTION。其核心功能是：

• 打印当前有效的用户 ID（effective UID）对应的名称。

这里的"有效用户 ID"是理解本命令的关键：它指的是进程当前真正生效的身份，而不是登录时记录的原始身份。在通过su、sudo切换用户后，有效用户 ID 会随之改变，因此whoami的输出会反映切换后的身份。

选项

whoami只支持两个选项，且都用于信息查询，不影响命令的打印行为：

--help 显示帮助信息并退出。 --version 显示版本信息并退出。

• whoami --help：输出命令的简短用法说明后正常退出（返回 0）。
• whoami --version：输出命令所属版本信息后正常退出，便于在脚本中确认 coreutils 版本。

除此之外，whoami不接受其他参数或选项，传入了多余参数会报错并返回非 0 值。

返回值

• 返回0表示成功。
• 返回非0值表示失败（例如环境异常、无法确定有效用户 ID 等情况）。

这一约定与 GNU coreutils 中绝大多数命令一致，可在脚本中直接通过$?检查执行结果。

例子

[root@localhost ~]# whoami root

在 root 用户的终端中执行whoami，直接输出root。由于whoami是基于有效用户 ID 查询，即便当前是通过su临时切换过来的非登录用户，它输出的也是切换后的用户，而非登录用户。

关键辨析：whoami 与 id -un

whoami命令等价于：

id -un

即id命令的-u（只打印有效的用户 ID）与-n（以名称而不是数字打印）两个选项的组合。仓库中的 command/id.md 文档详细列出了这两个选项的含义：

-u, --user 只打印有效的用户ID。 -n, --name 打印名称而不是数字。

因此，二者输出完全一致：

[root@localhost ~]# id -un root

不过id命令远比whoami强大：它还能打印真实与有效的 UID/GID、全部组信息、SELinux 安全上下文（-Z）等，例如：

[root@localhost ~]# id uid=0(root) gid=0(root) groups=0(root),1(bin),2(daemon),3(sys),4(adm),6(disk),10(wheel)

所以当你只需要"当前有效用户名"时用whoami即可；当需要完整身份信息（UID 号、GID 号、所属组、特定用户的身份）时，应改用 command/id.md 中介绍的id命令。

关键辨析：whoami 与 logname

这是文档中特意强调、也是最容易混淆的一对命令。以用户root打开终端后切换到用户user2，此时：

• whoami返回的是当前用户user2（基于有效用户 ID）；
• logname返回的是登录用户root（基于登录会话中记录的原始身份）。

仓库中的 command/logname.md 文档给出了logname的定义："打印当前终端登录用户的名称"，并重复强调了这一差异。你可以自行实践验证：

[root@localhost ~]# whoami root [root@localhost ~]# su - user2 [user2@localhost ~]$ whoami user2 [user2@localhost ~]$ logname root

实践建议：

• 判断"当前进程以哪个身份生效、会以谁的身份创建文件" → 使用whoami；
• 判断"这个终端最初是谁登录的、审计/记账场景下归因到谁" → 使用logname；
• 若要查看当前所有已登录用户及其终端、登录时间，可进一步参考仓库中的 command/who.md，执行who即可列出每个当前登录用户的名称、终端信息、登录时间与来源主机。

在 linux-command 仓库中检索与引用 whoami

whoami是 linux-command 仓库搜集整理的 600 多个 Linux 命令之一，在项目中有三种典型的使用方式：

1. 直接阅读 Markdown 手册：本命令的完整原始文档位于 command/whoami.md，仓库中每个命令都对应command/目录下的一个 Markdown 文件，可通过 Web 版搜索或直接翻阅源码目录获取。

2. Web 版检索：README 中说明，项目通过 GitHub Actions 将 command 目录中的命令文档生成为静态 HTML 并提供索引搜索（对应模板实现可见 template/details.ejs 与 scripts/dash.mjs），预览地址为https://git.io/linux，也可以在浏览器中直接搜索"whoami"定位到该命令详情页。

3. npm 包程序化引用：通过npm install linux-command安装后（见 package.json），可以用代码直接加载命令文档：

// 加载命令索引 JSON（package.json 中 "main": "dist/data.json"） var comm = require("linux-command"); // 索引中包含 whoami 的条目信息 console.log("---->", comm.whoami); // 或直接加载命令的 Markdown 原文 var whoamiDoc = require("linux-command/command/whoami.md"); console.log("---->", whoamiDoc); // markdown string

命令索引数据（dist/data.json）中同样登记了whoami条目（"whoami": { "n": "whoami", "p": "/whoami", ... }），供搜索引擎、Agent 与各类前端应用做命令名到详情页的映射。

底层实现与帮助信息

whoami属于 GNU coreutils 工具集，其底层通过系统调用读取进程的有效用户 ID（geteuid()），再在用户数据库中查表映射为用户名，本质上与id -un走的是同一套身份查询机制。正因为依赖进程的 effective UID，所以它天然能感知su/sudo带来的身份切换，这也是它与logname行为差异的根本原因。

更多权威帮助信息可通过以下方式获取：

man -s 1 whoami info coreutils 'whoami invocation'

若需横向对比，仓库中apropos命令的文档（command/apropos.md）在手册检索结果中也收录了whoami (1) - print effective userid，即"打印有效用户 ID"，与本文开头对命令功能的定义完全一致。

小结

一句话记住用法：想知道"我现在以谁的身份在跑命令"用whoami；想知道"这个终端当初是谁登录的"用logname。完整的命令手册可在 command/whoami.md 中随时查阅，也可通过本项目 Web 版（https://git.io/linux）或 npm 包离线使用。

• 文档
• 教程