Homebrew 完全指南：从安装、换源加速到核心命令速查

验证安装

brew --version 

显示版本号即安装成功：

切换国内镜像

由于 Homebrew 的软件源位于 GitHub，国内用户直接使用可能会遇到下载缓慢或失败的问题。强烈建议更换为国内镜像源，这能显著提升安装速度和成功率。

输入下述指令可以查看当前源：

git -C "$(brew --repo)" remote -v

默认源为 GitHub。

推荐使用清华大学镜像源，切换镜像源示例如下，切换镜像源的本质是修改其背后 Git 仓库的远程地址。

替换主仓库

• 替换 brew.git 仓库

git -C "$(brew --repo)" remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git

接着更新：

brew update

可选替代

下述需要你已经用 homebrew 下载安装过软件后，才可以执行，不然会出现文件不存在的情况：No such file or directory。

为什么会出现这种情况？

• Tap 机制：Homebrew 将软件分成了不同的'桶'（Taps）。
  • homebrew/cask：管理图形界面软件（你之前可能用过，所以它存在）。
  • homebrew/core：管理命令行工具（你没用过，所以它被'懒加载'了）。
• Update 的逻辑：brew update 默认只更新已经安装（Initialized）的 Taps。因为 core 还没被初始化，所以 update 跳过了它。

所以需要你之后下载过必要软件之后再来执行下述命令，可以替换镜像源。

• 替换 homebrew-core 仓库

git -C "$(brew --repo homebrew/core)" remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git

• 替换 homebrew-cask 仓库 (用于图形应用)

git -C "$(brew --repo homebrew/cask)" remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-cask.git

常用指令

掌握了这些常用命令，你就能像专家一样高效管理 macOS 上的软件了。

以下是最核心、最常用的 Homebrew 命令速查表，涵盖了日常使用的方方面面：

核心常用命令速查表

详细命令分类解析

搜索与发现 (search, info)

在安装之前，通常需要先确认软件是否存在或查看其详情。

查看软件信息：

brew info git 

输出会显示：当前版本、是否已安装、依赖关系、安装路径等。

搜索软件：

brew search google
brew search python 

安装与卸载 (install, uninstall)

这是最常用的功能。Homebrew 分为 Formula（命令行工具）和 Cask（图形界面应用）。

卸载软件：

brew uninstall wget
brew uninstall --cask google-chrome # 卸载图形应用需带上 --cask 

安装图形界面应用 (Cask)：

brew install --cask google-chrome
brew install --cask visual-studio-code 

安装命令行工具 (Formula)：

brew install wget
brew install node@18 # 安装指定版本 

更新与升级 (update, upgrade)

注意区分以下两个概念：

• update：去应用商店刷新货架（更新软件列表）。
• upgrade：把家里已有的旧东西换成新东西（升级已安装软件）。

升级指定软件：

brew upgrade git 

升级所有软件：

brew upgrade 

更新软件列表：

brew update 

状态与清理 (list, cleanup, outdated)

保持系统整洁。

清理缓存（释放磁盘空间）：

brew cleanup 

这会删除旧版本的安装包和缓存文件。

查看可升级的软件：

brew outdated 

列出已安装软件：

brew list # 列出命令行工具
brew list --cask # 仅列出图形界面应用 

诊断与帮助 (doctor, help)

查看帮助：

brew help
brew help install # 查看 install 命令的详细用法 

诊断环境问题：

brew doctor 

如果遇到安装报错，先运行这个命令，它会给出非常具体的修复建议。

进阶小贴士

查看依赖树：

brew deps --installed --tree 

查看已安装软件的依赖关系，非常直观。

锁定版本：如果你不希望某个软件在 upgrade 时被更新，可以将其锁定：

brew pin git # 锁定 git
brew unpin git # 解锁