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 手册按章节组织，同一名称可能出现在多个章节，含义完全不同：
Zynq Linux Hardware Debug
下载
Zynq‑7000 / Zynq UltraScale+ 硬件调试技能。适用于 Xilinx Zynq（Cortex‑A9/A53 + FPGA）Linux 环境，调试 I2C、I2S、UART、GPIO 等外设。包括设备树配置、内核驱动、用户空间调试工具、交叉编译和常见问题排查，支持 PetaLinux 开发。
-
man ls默认查第 1 章（用户命令），等价于man 1 ls -
man 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 往下翻两屏才能看到。
