在 macOS 上安装中文 man 手册页（man-pages-zh）

作为开发者，我们经常依赖 man 命令查阅 Unix/Linux 系统命令的使用说明。然而，macOS 虽然是基于 Unix 的操作系统，其内置的 man 页面均为英文，且部分命令的行为或参数与 Linux 系统存在差异。尽管阅读英文文档是程序员的基本功，但一份清晰准确的中文手册无疑能提升效率、降低理解门槛。

幸运的是，社区早已有人完成了这一工作——man-pages-zh 项目提供了高质量的中文 man 手册翻译，并支持 macOS 平台。本文将详细介绍如何在 macOS Sequoia (15.6.1) 上从源码编译并安装该中文手册。

注意：截至本文撰写时（2025 年），该项目尚未提供 macOS 的预编译安装包，需通过源码编译安装。

前置依赖

编译 man-pages-zh 需要以下工具和环境：

1. OpenCC：用于简繁体转换

   1 2	brew install opencc # 验证版本（示例）：opencc --version → 1.1.9

2. CMake：构建系统

   1 2	brew install cmake # 验证版本（示例）：cmake --version → 4.2.1

3. Python 3：用于构建脚本
   可通过 Homebrew 安装：

   1	brew install python@3

   或更推荐使用 Miniconda3 管理 Python 环境（本文不展开配置细节）。

下载源码

前往 man-pages-zh GitHub Releases 页面，选择最新稳定版本。本文以 v1.6.4.3 为例：

1
2
3

wget https://github.com/man-pages-zh/manpages-zh/archive/refs/tags/v1.6.4.3.tar.gz
tar -xzvf v1.6.4.3.tar.gz
cd manpages-zh-1.6.4.3

也可使用 git clone，但 Release 包更轻量且稳定。

编译与安装

按照项目 README.md 中的说明执行构建流程：

1
2
3
4

mkdir build && cd build
cmake ..
make
sudo make install

默认情况下，中文手册将被安装到 /usr/local/share/man/zh_CN/ 目录。

配置别名（以 Zsh 为例）

为方便使用，建议设置一个别名（如 cman）来调用中文手册：

1
2

echo "alias cman='man -M /usr/local/share/man/zh_CN'" >> ~/.zshrc
source ~/.zshrc

若你使用 Bash，请修改 ~/.bashrc 或 ~/.bash_profile。

验证安装

尝试查看 ls 命令的中文手册：

1

cman ls

在 macOS Sequoia (15.6.1) 上，显示正常，无乱码问题（得益于系统对 UTF-8 的良好支持）。

小结

通过以上步骤，你已成功在 macOS 上启用了中文 man 手册。这不仅提升了命令行工具的学习效率，也降低了新用户入门 Unix-like 系统的门槛。

提示：并非所有命令都有中文翻译，若 cman xxx 未找到对应页面，可回退使用原生 man xxx 查看英文版。

希望这篇指南对你有所帮助！如有疑问，欢迎留言交流。