必须先添加第三方Tap仓库才能安装Homebrew官方未收录的工具;执行brew tap user/repo添加,brew tap列出已启用Tap,brew search或brew install加命名空间验证,brew untap移除。

想在Mac上用Homebrew安装官方仓库没有收录的工具,比如某个开发者自己打包的命令行小工具、内部测试版软件或定制编译的PHP旧版本,就必须先添加对应的第三方Tap仓库。
确认Homebrew已正确安装并更新
打开终端,运行 brew --version。若返回类似 Homebrew 4.3.5 的版本号,说明已安装;若提示命令未找到,请先完成Homebrew安装。接着执行 brew update,确保本地索引与远程仓库同步——这一步跳过会导致后续 brew tap 找不到新仓库或报 No available formula or cask 错误。
用 brew tap 命令添加第三方Tap
执行以下命令即可添加任意公开的Tap:
brew tap <user>/<repo>
例如,要添加 cyperx84 维护的私人仓库,输入:
brew tap cyperx84/tap
Homebrew会自动从 https://github.com/cyperx84/homebrew-tap 克隆仓库到本地 /opt/homebrew/Library/Taps/cyperx84/homebrew-tap(Apple Silicon)或 /usr/local/Homebrew/Library/Taps/cyperx84/homebrew-tap(Intel)。该操作不可逆,若路径已存在同名目录,Homebrew会强制覆盖——【请确保该路径下无重要自定义文件】。
添加成功后,终端会输出类似 Tapping cyperx84/tap... (16 files) 的提示,表示已加载其中所有Formula和Cask定义。
验证Tap是否生效
方法一:列出当前已启用的所有Tap
brew tap
输出中应包含 cyperx84/tap(或其他你刚添加的名称)。
方法二:搜索该Tap内的可用软件
brew search --casks --desc "keyword" 或直接 brew search 查看全部,也可限定范围:brew search cyperx84/。注意末尾斜杠不能省略,否则无法匹配Tap命名空间。
方法三:尝试安装一个该Tap中明确存在的包(如仓库README里写的)
brew install cyperx84/tap/your-tool-name
如果返回 Error: No available formula or cask with the name "cyperx84/tap/your-tool-name",大概率是拼写错误或该Formula尚未提交到主分支——此时应前往对应GitHub仓库的 Formula/ 目录人工确认.rb文件是否存在。
移除不再需要的Tap
第一步:卸载该Tap下所有已安装的软件包
运行 brew list --tap=cyperx84/tap 查出已装项,逐个执行 brew uninstall <package>。
第二步:执行移除命令
brew untap cyperx84/tap
Homebrew将删除本地Taps目录下的整个 cyperx84/homebrew-tap 文件夹。该操作不会影响其他Tap或已通过其他源安装的软件。

















