Mac 安装中文版 man 帮助命令

中文版 man 官网地址

1. 安装编译工具

因为需要编译安装，所以，我们需要先安装两个编译工具。编译工具我们使用 brew 进行安装，如果你没有安装 brew 则需要先安装 Homebrew。

1
2
3
4
5
6
7
8
# 安装 Homebrew
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

# 安装 automake
brew install automake

# 安装 opencc
brew install opencc

2. 中文版 man 安装

下载 manpages-zh-1.6.3.3，并解压，然后 cd 进入解压后的目录准备安装。

1
2
3
4
5
6
7
8
9
10
11
# 进入源码包文件夹
cd manpages-zh-1.6.3.3

# 开始编译安装
autoreconf --install --force
./configure
sudo make
sudo make install

# 我们就安装上了中文版本的 man 工具了，但是运行命令会发现乱码。
man ls

3. 解决中文乱码

乱码的主要原因是 Mac 的 groff 版本比较老，可以利用以下命令查看版本

1
2
groff -v
# 我的版本是 GNU groff version 1.19.2

先到网站 groff.git 下载 groff 新版本，一般 1.22版本 即可。下载完成之后，解压进入目录，进行安装。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
# 进入目录
cd groff-1.22

# 编译安装
./configure
sudo make
sudo make install

# 打开配置文件
sudo vi /etc/man.conf
# 进入编辑器之后，在文件末尾加上如下语句，然后保存退出。
NROFF preconv -e UTF8 | /usr/local/bin/nroff -Tutf8 -mandoc -c

# 运行命令，完美解决乱码问题
man ls

4. 如何查看原版英文文档

1
2
3
4
5
6
7
8
# 查看有几个版本的文档
man -aw ls
/usr/local/share/man/zh_CN/man1/ls.1
/usr/share/man/man1/ls.1
/Library/Developer/CommandLineTools/SDKs/MacOSX.sdk/usr/share/man/man1/ls.1

# 进入第一个文档，按 q 退出当前文档并进入下一个文档，即可查看原版英文版文档。
man -a ls

本文参考：
https://juejin.im/post/5c6e0182f265da2d9710ef5d
https://www.jianshu.com/p/5e35202fc59c