在mac终端中用man命令查看命令手册页:输入man 命令名(如man ls)查看,默认显示第1章;用man -aw 命令名查所有章节路径,man n 命令名指定章节;空格翻页、b回退、/搜索、q退出;中文手册需安装manpages-zh并配置wman别名。

在Mac终端中快速查清命令用法、参数含义和典型示例,最直接的方式就是调用系统内置的手册页(Man Page),不需要联网、不依赖第三方工具,但必须知道正确触发方式和退出方法。
基础查看:用 man 命令打开手册
在终端中输入 man 后跟空格和你要查的命令名,例如查 ls 命令:man ls,然后按 Return 键执行。
页面会以分页形式显示,顶部显示命令名、章节号(如 LS(1))、简短描述;内容包含语法、选项说明、示例、相关命令等。
这一步操作起来很简单,直接敲完回车就行,但注意别漏掉空格——manls 会被系统识别为一个不存在的命令。
快速定位手册位置与可用章节
有些命令在多个章节存在同名条目(比如 printf 既有 shell 内建命令,也有 C 函数库版本),系统默认只显示第一个匹配项。
想确认某命令在哪些章节有文档,运行:man -aw 命令名,例如 man -aw printf,终端会列出所有匹配路径,如 /usr/share/man/man1/printf.1.gz 和 /usr/share/man/man3/printf.3.gz。
要指定查看第3章(C函数)的手册,就写成 man 3 printf;不写数字则默认查第1章(用户命令)。
高效浏览与退出手册页
进入 man 页面后,你处于 less 程序的阅读模式,不是普通文本编辑器。
空格键翻页,b 键回退一页,/ 后输入关键词可搜索(如 /recursive 查递归相关说明),n 跳到下一个匹配项。
按 q 键是唯一可靠退出方式,其他按键如 Ctrl+C 或 Esc 可能无效,强行关窗口会导致终端残留乱码或卡顿。
退出后光标自动回到命令行起始位置,可继续输入新命令。
中文手册支持(可选扩展)
系统默认只提供英文 man 页面。若需中文说明,需手动安装中文 manpages-zh 项目并配置别名。
方法一:使用 Homebrew 安装依赖与中文包
先确保已装 brew,再依次运行:
brew install autoconf automake opencc python3 → git clone https://github.com/man-pages-zh/manpages-zh.git → cd manpages-zh → autoreconf --install --force → ./configure → make → sudo make install
方法二:配置 wman 别名快速调用中文版
编辑 ~/.zshrc 文件,末尾添加:
alias wman='man -M /usr/local/share/man/zh_CN' → 执行 source ~/.zshrc 生效 → 之后用 wman ls 即可查看中文 ls 手册。
注意:若执行 wman 后出现乱码,说明终端未启用 UTF-8 编码,需检查终端设置或 LANG 环境变量是否为 zh_CN.UTF-8。











