如何用Ruby与Homebrew将脚本手册页迁移至/usr/local/share/man/man1？

安全阿岳

2026-5-6

嘿，这个问题我熟！不管你是用Homebrew管理脚本还是手动部署，都有对应的方法搞定man页的安装，下面分两种情况给你说明：

用Homebrew Formula管理的情况

如果你是通过Homebrew的Formula来打包和安装自己的脚本，Homebrew提供了专门的语法来处理man页，不用手动拼接路径：

针对man1章节的手册页（也就是脚本对应的.1后缀文件），直接在Formula里使用man1.install方法：
```
man1.install "your-script-name.1"
```
执行这个命令后，Homebrew会自动把手册页放到/usr/local/Cellar/your-formula/[版本号]/share/man/man1目录，还会自动在/usr/local/share/man/man1下创建符号链接，确保系统的man命令能直接找到它。
如果你的手册页属于其他章节（比如.5后缀的配置文件手册），把man1换成对应的章节号即可，比如man5.install。
要是有多个man页需要安装，用数组一次性处理更高效：
```
man1.install ["script-1.1", "script-2.1"]
```

如果不需要通过Homebrew，直接手动部署脚本和man页，步骤也很简单：

把你的手册页文件复制到目标目录：
```
cp your-script-name.1 /usr/local/share/man/man1/
```
（如果提示权限不足，在命令前加sudo即可）
更新man数据库，让系统识别到新的手册页：
```
mandb
```
完成后，你输入man your-script-name就能查看对应的手册页了。