Homebrew 常用命令

2026-07-20 15:00:00

Homebrew 是什么

Homebrew 是一个开源包管理器，可用于 macOS、Linux 和 WSL。它可以统一完成软件的搜索、安装、升级、卸载和依赖管理。

Homebrew 中最常见的两类软件包是：

Formula（配方）：通常是命令行工具、编程语言、库或后台服务，例如 git、node、wget、redis。
Cask（桶）：通常是带图形界面的 macOS 应用、字体或插件，例如 visual-studio-code、google-chrome。

可以在官方的 Homebrew Formulae 页面查询软件包名称、当前版本、依赖和安装命令。

高频命令速查

命令	用途
`brew search <关键词>`	搜索 Formula 和 Cask
`brew info <包名>`	查看软件包信息
`brew install <包名>`	安装 Formula
`brew install --cask <包名>`	安装 Cask
`brew list`	查看已安装的软件包
`brew list --versions <包名>`	查看指定软件的已安装版本
`brew update`	更新 Homebrew 和软件包元数据
`brew outdated`	查看可升级的软件包
`brew upgrade`	升级全部未锁定的软件包
`brew upgrade <包名>`	升级指定软件包
`brew uninstall <包名>`	卸载软件包
`brew cleanup --dry-run`	预览可清理内容
`brew cleanup`	清理旧版本和过期缓存
`brew services list`	查看后台服务状态
`brew doctor`	检查 Homebrew 环境

安装 Homebrew

安装前建议先阅读官方的 Installation 文档。在 macOS 上，如果尚未安装 Xcode Command Line Tools，可以先执行：

1
xcode-select --install

然后使用官网提供的安装脚本：

1
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

安装结束后，应按照终端给出的提示配置 brew shellenv。Homebrew 的默认安装目录通常为：

Apple Silicon Mac：/opt/homebrew
Intel Mac：/usr/local
Linux：/home/linuxbrew/.linuxbrew

验证安装是否成功：

1
2
brew --version
brew doctor

brew doctor 会检查系统中可能影响 Homebrew 的配置问题。它给出的部分内容只是警告；如果相关功能能够正常使用，不一定需要逐条处理。

获取帮助与查看环境

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
# 查看常用命令和帮助
brew help

# 查看某个命令的详细帮助
brew help install

# 查看版本
brew --version

# 查看 Homebrew、Ruby、Git、系统等配置信息
brew config

# 查看 Homebrew 的安装前缀
brew --prefix

# 查看全部可用命令
brew commands

# 打开完整手册
man brew

Homebrew 的完整命令说明也可以直接查看官方 brew(1) 手册。

搜索与查看软件包信息

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
# 同时搜索 Formula 和 Cask
brew search <关键词>

# 查看软件包介绍、版本、依赖和安装选项
brew info <包名>

# 只按 Formula 查询
brew info --formula <包名>

# 只按 Cask 查询
brew info --cask <包名>

# 在浏览器中打开软件包的项目主页
brew home <包名>

例如：

1
2
3
brew search node
brew info node
brew info --cask visual-studio-code

安装、重装与卸载

安装 Formula

1
2
3
4
5
# 安装单个命令行工具
brew install wget

# 一次安装多个软件包
brew install git node ripgrep

安装 Cask

1
2
3
4
5
# 安装 macOS 图形应用
brew install --cask visual-studio-code

# 一次安装多个图形应用
brew install --cask firefox iina

重装与卸载

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
# 重新安装软件包，常用于修复文件缺失或安装损坏
brew reinstall <包名>

# 重新安装 Cask
brew reinstall --cask <包名>

# 卸载 Formula 或 Cask
brew uninstall <包名>
brew uninstall --cask <包名>

# 卸载 Cask，并尝试删除其关联配置文件
brew uninstall --cask --zap <包名>

--zap 可能删除与其他应用共享的文件，执行前应先用 brew info --cask <包名> 查看相关信息。

查看已安装的软件

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
# 列出全部已安装的软件包
brew list

# 分别列出 Formula 和 Cask
brew list --formula
brew list --cask

# 列出已安装的软件及版本
brew list --versions

# 查看指定软件的已安装版本，无需再配合 grep
brew list --versions <包名>

# 只列出手动安装、不是作为依赖安装的 Formula
brew leaves

更新与升级

update 和 upgrade 的作用不同：

brew update：更新 Homebrew 自身和软件包元数据。
brew upgrade：升级已经安装的软件包。

常用命令如下：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
# 更新 Homebrew 和软件包元数据
brew update

# 查看哪些软件可以升级
brew outdated

# 查看 Formula 或 Cask 中可以升级的软件
brew outdated --formula
brew outdated --cask

# 升级全部未锁定的软件包
brew upgrade

# 升级指定软件包
brew upgrade <包名>

# 只升级 Cask
brew upgrade --cask
brew upgrade --cask <包名>

# 预览将要升级的软件，不执行实际升级
brew upgrade --dry-run

如果需要临时保持某个版本，可以锁定软件包：

1
2
3
4
5
6
7
8
# 禁止指定软件包被 brew upgrade 升级
brew pin <包名>

# 查看已锁定的软件包
brew list --pinned

# 解除锁定
brew unpin <包名>

锁定旧版本可能使依赖它的其他软件无法正确安装或运行，因此不建议长期锁定。

清理缓存与无用依赖

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
# 预览 cleanup 将删除的旧版本、过期下载和缓存
brew cleanup --dry-run

# 清理全部软件包的旧版本和过期缓存
brew cleanup

# 只清理指定软件包
brew cleanup <包名>

# 预览已经不再需要的依赖
brew autoremove --dry-run

# 卸载已经不再需要的依赖
brew autoremove

# 查看 Homebrew 下载缓存的位置
brew --cache

建议先执行带有 --dry-run 的命令，确认待删除内容后再真正清理。

查看依赖关系

1
2
3
4
5
6
7
8
# 查看指定 Formula 的依赖
brew deps <包名>

# 以树形结构显示全部依赖
brew deps --tree <包名>

# 查看哪些已安装软件依赖指定 Formula
brew uses --installed <包名>

在卸载底层库之前，先运行 brew uses --installed <包名>，可以避免误删其他软件仍在使用的依赖。

管理后台服务

数据库、缓存等 Formula 可以通过 brew services 管理。例如安装 Redis 后：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
# 查看 Homebrew 管理的服务及其状态
brew services list

# 启动服务，并在当前用户登录时自动启动
brew services start redis

# 停止服务，并取消登录时自动启动
brew services stop redis

# 重启服务
brew services restart redis

# 查看指定服务的详细信息
brew services info redis

在 macOS 上，不带 sudo 时服务属于当前用户，通常已经足够。只有明确需要系统级开机服务时才考虑使用 sudo brew services ...。

管理第三方仓库 Tap

Tap 是 Homebrew 的第三方软件仓库。一般安装官方 Formula 和 Cask 时不需要手动添加 Tap。

1
2
3
4
5
6
7
8
# 查看已经添加的 Tap
brew tap

# 添加第三方 Tap
brew tap <用户或组织>/<仓库>

# 删除 Tap
brew untap <用户或组织>/<仓库>

添加第三方 Tap 前，应确认其来源和维护状态。Homebrew 官方的 Tap 说明见 Taps 文档。

使用 Brewfile 备份和恢复软件列表

当需要迁移 Mac 或为团队统一开发环境时，可以用 Brewfile 记录已安装的软件。详细说明见官方的 Homebrew Bundle 文档。

1
2
3
4
5
6
7
8
# 将当前目录下的软件状态导出为 Brewfile
brew bundle dump --file=./Brewfile --force

# 检查 Brewfile 中的软件是否都已安装
brew bundle check --file=./Brewfile

# 按 Brewfile 安装或恢复软件
brew bundle install --file=./Brewfile

Brewfile 可以提交到 Git 仓库中，方便在新设备上恢复命令行工具、图形应用和 Tap。

常用维护流程

日常维护可以按照下面的顺序执行：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
# 1. 更新 Homebrew 和软件包元数据
brew update

# 2. 查看可升级的软件
brew outdated

# 3. 升级软件
brew upgrade

# 4. 预览并清理旧版本和缓存
brew cleanup --dry-run
brew cleanup

# 5. 遇到异常时检查环境
brew doctor

常见问题

安装成功后提示 `brew: command not found`

通常是没有完成安装程序最后给出的 shellenv 配置。先重新查看安装输出，并将它建议的命令加入 ~/.zprofile、~/.zshrc 或当前 Shell 对应的配置文件。Apple Silicon Mac 当前终端也可以临时执行：

1
eval "$(/opt/homebrew/bin/brew shellenv)"

如何确认一个命令来自哪个软件包

1
brew which-formula <命令名>

例如，brew which-formula wget 会查询提供 wget 命令的 Formula。

从哪里开始排查错误

1
2
3
brew update
brew doctor
brew config

然后查看官方的 Troubleshooting 和 FAQ。提交问题时，brew config 的输出通常有助于说明运行环境，但公开前仍应检查是否包含不希望披露的信息。