Mac安装中文版man命令指南

为什么需要 man 以及 man 怎么使用

linux 或者 mac 系统的命令行非常多，可是不可能记住所有的这些命令，通常只能记住一些我们常用的。遇到不常用的需要来查询一下这个函数是怎么使用的。这时候就需要使用到 man 命令了。

使用方法也非常简单，例如不清楚 ls 这个命令的使用方法，就可以在命令行中输入

man ls

但是默认情况下，输出的内容是英文的。可能很多英文不好的希望有中文版本的 man ，这篇博文就是告诉大家，如何在 mac 上安装中文版本的的 man。

下载 manpages-zh 编辑安装

首先，打开的 github 地址，点击 releases 下载最新版本的 tar.gz 源码包。目前我下载到的是 1.6.3.4 版本的。

因为需要编译安装，所以电脑上需要有编译工具，运行下面两个命令安装

brew install automake
brew install opencc

然后继续安装manpages-zh:

cd ~/Downloads/
# 下载最新版本的源码包
wget https://github.com/man-pages-zh/manpages-zh/archive/v1.6.3.4.tar.gz
tar zxvf v1.6.3.4.tar.gz
# 进入源码包文件夹安装
cd manpages-zh-1.6.3.4/
autoreconf --install --force
./configure
make
sudo make install
# 配置别名并让他生效
echo "alias cman='man -M /usr/local/share/man/zh_CN'" >> ~/.bash_profile
. ~/.bash_profile

由于 mac 上的 groff 工具比较老，所以中文会出现乱码。

安装 groff 新版本解决中文乱码的问题

首先，到 http://git.savannah.gnu.org/cgit/groff.git 这个页面下载 1.22 版本的 groff 安装包。如下为命令行安装：

cd ~/Downloads/
wget http://git.savannah.gnu.org/cgit/groff.git/snapshot/groff-1.22.tar.gz
# 解压
tar zxvf groff-1.22.tar.gz
cd groff-1.22
# 编译安装
./configure
sudo make
sudo make install
# 添加配置
sudo vim /etc/man.conf

在进入编辑模式后，在末尾添加：

NROFF preconv -e UTF8 | /usr/local/bin/nroff -Tutf8 -mandoc -c

保存退出后，就可以使用man命令中文手册了。