Mac Homebrew 使用指南

一、Homebrew 是什么

macOS 上的包管理器。你装软件不用再去官网下 .dmg 拖拽安装了，打开终端敲一行命令就行。

比如装 Node.js，传统：去 nodejs.org → 下载 → 双击安装。brew 的做法：

brew install node

—— 完事。

二、安装 Homebrew（跟着做）

第 1 步：先装 Xcode Command Line Tools

打开终端，粘贴执行：

xcode-select --install

弹出安装窗口 → 点 安装 → 等几分钟。如果提示 already installed，跳过这一步。

第 2 步：一键安装 Homebrew

终端粘贴这一行，回车：

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

这条命令在干什么

• curl -fsSL：从 GitHub 下载安装脚本（静默模式、跟随跳转、出错停止）

• | bash：把脚本交给 shell 执行

• 脚本会自动：检测 macOS 版本 → 确定安装路径（M 芯片 /opt/homebrew，Intel /usr/local）→ 克隆仓库 → 配置权限

执行中你会看到什么

• 先输出：This script will install: /opt/homebrew/bin/brew

• 然后：Press RETURN to continue — 按回车

• 需要输入开机密码（输字符不显示，正常）

• 最后：Installation successful! + 两行 Next steps

第 3 步：把 brew 加到 PATH

复制终端里显示的 Next steps 那两行，挨个复制执行：

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile

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

关掉终端重新打开，输入 brew 就能用了。

第 4 步：验证

brew --version

输出 Homebrew 4.x.x 即成功。

第 5 步（重要）：换国内镜像

以下逐条复制执行：

echo 'export HOMEBREW_BREW_GIT_REMOTE="https://mirrors.ustc.edu.cn/brew.git"' >> ~/.zprofile

echo 'export HOMEBREW_CORE_GIT_REMOTE="https://mirrors.ustc.edu.cn/homebrew-core.git"' >> ~/.zprofile

echo 'export HOMEBREW_BOTTLE_DOMAIN="https://mirrors.ustc.edu.cn/homebrew-bottles"' >> ~/.zprofile

source ~/.zprofile

做完。后面装任何东西都快得多。

三、日常操作（照做就行）

装好并配好镜像后，日常使用基本就是下面四个情景。

情景 1：我要装一个东西

先搜有没有：

brew search 关键词

搜索结果分两大类，以搜 clash 为例：

brew search clash

你会看到：

==> Formulae（命令行工具）
crash (deprecated)             flash                          clac

==> Casks（桌面 GUI 应用）
clash-mi               clash-party            clash-verge-rev

• Formulae = 命令行工具，终端里跑的（如 crash 是调试工具，不相关）

• Casks = 带界面的桌面应用，用 --cask 安装

这里 clash-verge-rev 就是最主流的 Clash 图形客户端，原生 clash 只是命令行内核、不带界面，所以 Formulae 里搜不到。

看详情：

brew info 包名

安装命令行工具：

brew install git

安装桌面 GUI 应用（带 —cask）：

brew install --cask clash-verge-rev

等待下载完成，在启动台就能打开。

一次装多个：

brew install git node wget tree

情景 2：我要更新软件

刷新索引：

brew update

看哪些能更新：

brew outdated

升级全部：

brew upgrade

只升级某一个命令行：

brew upgrade node

升级 GUI 应用（带 —cask）：

brew upgrade --cask clash-verge-rev

情景 3：我要删掉某个软件

卸载命令行工具：

brew uninstall node

卸载 GUI 应用：

brew uninstall --cask google-chrome

清理残留和旧版本：

brew cleanup

情景 4：我想看看装过什么

列出全部：

brew list

只列命令行工具：

brew list --formula

只列 GUI 应用：

brew list --cask

带版本号：

brew list --versions

四、必装软件清单

新 Mac 一次性装完，整段复制跑：

brew install git node python cmake wget tree htop tldr ffmpeg

brew install --cask google-chrome visual-studio-code iterm2 wechat docker rectangle

各包说明：

五、进阶操作

除了装卸软件，Homebrew 还能管理后台服务、锁定版本、迁移整机配置。

启动/关闭后台服务（MySQL、Redis 等）

启动：

brew services start mysql

停止：

brew services stop mysql

重启：

brew services restart mysql

查看所有服务：

brew services list

锁定某个软件不升级

brew pin node@20

解除锁定：

brew unpin node@20

换新 Mac 一键迁移所有软件

旧电脑导出清单：

brew bundle dump --file=~/Brewfile

Brewfile 拷到新电脑后，一键安装：

brew bundle --file=~/Brewfile

六、遇到问题怎么办

最后记录几个高频问题的处理办法。

brew update 卡住

网络问题，先确保第 5 步镜像已换，然后：

brew update-reset && brew update

报 Permission denied

brew doctor

装了但命令找不到

检查 PATH：

echo $PATH

确认包含 /opt/homebrew/bin。没有就重做第 3 步。

太占磁盘空间

brew cleanup -s

彻底卸载 Homebrew

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

（注：部分内容可能由 AI 生成）