man是唯一能直接打开完整、权威、离线命令手册页的工具;它默认查第1章(用户命令),如man ls等价于man 1 ls,而man 5 passwd则查看/etc/passwd文件格式,章节不同内容完全不同。

man 是唯一能直接打开完整、权威、离线命令手册页的工具,其他方式(如 --help、info)都只是补充或简化版。
man 命令怎么用才不卡住
输入 man ls 后卡在黑屏?这不是 bug,是进入了 less 分页器。常见操作必须记牢:
- 按
q退出 —— 这是最容易被忽略的出口 - 按
/再输入关键词(比如/color)搜索选项,回车后按n跳到下一个匹配处 - 空格键向下翻页,
b向上翻页;回车键逐行下移 - 如果终端显示
Manual page ls(1) line 1/123,说明手册已加载成功,不是卡死
为什么 man ls 和 man 1 ls 结果一样,但 man 5 passwd 就不一样
Linux 手册按章节组织,同一名称可能出现在多个章节,含义完全不同:
man ls默认查第 1 章(用户命令),等价于man 1 lsman passwd默认也查第 1 章(passwd命令),但man 5 passwd查的是/etc/passwd文件格式说明 —— 这是完全不同的文档- 用
man -k passwd可列出所有含passwd的手册页,看到passwd (1)和passwd (5)并存 - 误用
man 3 printf查库函数,却想解决 shell 脚本问题,就会跑偏
哪些命令不能靠 man 查,必须用 help
Shell 内置命令没有独立可执行文件,man cd 或 man source 往往失败或内容过时,必须用 help:
help cd显示cd的真实行为(比如-P和-L的路径解析逻辑)help -s echo快速看语法摘要:echo [-neE] [arg ...]help -m set以类 man 格式输出,带 section 划分,比纯文本更清晰- 注意:
help只对当前 shell 支持的内置命令有效,help git会报错
--help 不可靠时怎么办
ls --help 输出可读,但 systemctl --help 可能只列几个高频子命令,docker --help 甚至不显示所有子命令 —— 这不是 bug,是设计选择:
--help是命令作者写的“速查贴士”,内容由上游决定,不可控- 遇到
command: invalid option -- 'h'或静默无输出,立刻切到man command - 某些命令(如
bash)支持bash --help,但详细参数解释仍在man bash的 “SHELL BUILTIN COMMANDS” 节 - 别依赖
--help查配置文件语法(如nginx.conf),那是man 5 nginx或最新文档的事
容易被忽视的是:手册页中每个选项的「适用场景」和「副作用」通常隐藏在 DESCRIPTION 或 NOTES 段落里,而非 OPTIONS 表格中。比如 cp -a 看似只是归档开关,实则隐含 -pR --preserve=all,并且在某些文件系统上会触发额外权限检查——这些内容只有在 man cp 后往下翻两屏才能看到。