【2026实测】Homebrew安装、配置国内源、使用一篇搞定（多种安装方式）

下载 homebrew.pkg 安装包：homebrew.pkg（源自 Github，放心使用）

Homebrew 是 macOS 上最流行的包管理工具，完全免费开源，也被称为"macOS 缺失的包管理器"。它的核心作用就是让你能用一行命令安装、更新、管理各种开发工具和软件，比如 Git、Python、Node.js、Wget 等，不用再跑到各个软件的官网去手动下载安装包了。

在没有 Homebrew 的时代，在 macOS 上装开发工具是一件挺折腾的事。去官网找安装包、手动解决依赖关系、升级卸载还容易残留文件。Homebrew 改变了这一切，brew install 一条命令自动完成下载、解决依赖、编译安装和环境配置。

同领域的包管理工具各有各的适用场景：

工具	平台	核心定位	软件来源	图形界面应用
Homebrew	macOS / Linux	通用包管理	Formula + Cask	✓ brew install --cask
MacPorts	macOS	类Unix包管理	Portfile	部分支持
Spack	Linux / macOS	科学计算包管理	Package recipe	✗
APT (Linux)	Linux 发行版	系统包管理	Debian 仓库	✓

Homebrew 的核心概念不多，搞懂了就很好上手：

• Formula 是命令行工具的安装配方，用来安装 Git、Python 这类工具；
• Cask 是用来装图形界面应用的，比如 Chrome、VS Code、微信这类带图标的软件；
• Tap 是第三方仓库，可以添加额外的软件源。

下面从安装开始，一步步教你用起来。

安装Homebrew

安装 Homebrew 有多种方式，官网提供了官方安装脚本，直接一条命令就能装，也可以下载 homebrew.pkg 离线安装包，下载后本地运行。

1) 下载pkg安装包（新手推荐看，系统版本至少 macOS 14）

这种方式不需要开终端输命令，对不熟悉命令行的用户更友好，也适合在局域网里分发批量安装。

下载 homebrew.pkg 安装包：homebrew.pkg（源自 Github，放心使用）

直接双击 homebrew.pkg 打开，安装向导会自动引导你完成安装：


和装其他 macOS 软件一样，一路继续就行。安装完成后 Homebrew 会自动安装到默认路径，Apple Silicon 芯片的 Mac 装到 /opt/homebrew，Intel 芯片的 Mac 装到 /usr/local。

2）脚本安装Homebrew

安装 Homebrew 前需要先安装 Command Line Tools，在终端里输入以下命令：

xcode-select --install

执行后会弹窗提示安装，点击"安装"等待完成就行。这一步是必须的，Homebrew 依赖 Xcode 的命令行工具来编译软件。

① 国内镜像安装Homebrew

国内用户直接跑官方脚本可能会非常慢甚至连不上，推荐用国内镜像安装脚本，一条命令搞定：

/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"

输入命令后会提示输入序号，比如选择 1：


继续输入电脑密码：


输入 y：


按回车键继续：


再次输入密码：


安装 Homebrew 成功后，可以继续配置软件下载源：

② 官方脚本安装Homebrew

如果你网络环境好，可以正常访问 Github，可以直接用官方脚本：

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

③ Git 克隆安装

如果前两种都因为网络问题搞不定，可以用 Git 克隆的方式：

sudo git clone https://github.com/Homebrew/brew /opt/homebrew

克隆完成后把 brew 添加到 PATH 环境变量里就能用了。这种方式的优点是离线也能搞，只要有一次拿到完整的 Git 仓库就行。

验证安装Homebrew

安装完成后，终端输入 brew --version 查看版本号，如果显示了版本号（格式为：Homebrew  x.x.x）说明 Homebrew 安装成功：


再跑一下 brew doctor，这个命令会检查 Homebrew 的环境状态，如果有问题会给出修复建议，没有红色警告和错误就是正常状态。

Homebrew配置国内镜像源

前面没有配置国内下载源的，可以参考下面的步骤手动配置。

安装完成后，强烈建议把 Homebrew 的镜像源换成国内的，否则后面装软件会非常慢。这里推荐两种，选一个设置就行。

中科大镜像源：

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

清华大学镜像源：

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

切换完后还可以配置环境变量加速下载：编辑 ~/.zshrc 文件（nano ~/.zshrc），在末尾添加三行配置：

export HOMEBREW_BREW_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git"
export HOMEBREW_API_DOMAIN="https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles/api"
export HOMEBREW_BOTTLE_DOMAIN="https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles"

保存退出后 source ~/.zshrc 让配置生效，再运行 brew update 更新一下，后续下载速度会明显提升。

Homebrew基础使用

Homebrew 的常用命令不多，掌握下面这张表里的几个核心操作就能应付绝大部分场景：

操作	命令格式	说明
搜索软件	brew search 关键字	搜索可用的软件包，如 brew search python
查看信息	brew info 软件名	查看版本、依赖、安装说明等详细信息
安装命令行工具	brew install 软件名	自动下载解压配置环境，如 brew install git
安装图形界面应用	brew install --cask 应用名	命令行版应用商店，如 brew install --cask google-chrome
更新软件列表	brew update	刷新本地软件列表，装新软件前建议先跑
升级已装软件	brew upgrade [软件名]	不指定软件名则升级全部已装软件
卸载软件	brew uninstall [--cask] 软件名	图形界面应用需加上 --cask
查看已装软件	brew list [--cask]	列出已安装的软件，加 --cask 只看图形界面应用
清理缓存	brew cleanup	删除旧版本安装包和缓存，释放硬盘空间
诊断环境	brew doctor	检查 Homebrew 环境，排错神器，遇到报错先跑这个

还有一些进阶小技巧：

• 如果不想某个软件被升级，可以用 brew pin 软件名 锁定版本，brew unpin 软件名 解锁。
• 用 brew deps --installed --tree 可以查看当前已装软件的依赖关系树，对自己装了什么东西很清楚。

常见使用问题

1）安装时提示"Permission denied"权限不足

这是因为 Homebrew 安装目录的权限问题，可以用 sudo chown -R $(whoami) $(brew --prefix)/* 修改目录权限，把所有权从 root 改成当前用户。不过在新版 Homebrew 中这个问题已经很少出现了，如果遇到，先试试 brew doctor 看它给出的修复建议。

2）brew update 非常慢或者卡住不动

这是国内用户最常见的问题，原因是从 GitHub 拉取数据时网络不稳定。解决方案就是上面说的配置国内镜像源，换成中科大或清华的源之后速度会快很多。如果已经配置了镜像但还是慢，检查一下环境变量有没有生效，重新 source 一下配置文件。

3）安装软件时提示 Homebrew 版本太旧

先跑 brew update 更新 Homebrew 自身和软件列表，然后再 brew install。如果 update 后还是提示旧版本，可能是镜像源没有及时同步，换一个镜像源试试。

4）想恢复官方源怎么办

修改镜像源的命令反过来就行，把远程地址改回 GitHub 官方地址：

# 重置 brew.git
git -C "$(brew --repo)" remote set-url origin https://github.com/Homebrew/brew.git

# 重置 homebrew-core.git
git -C "$(brew --repo homebrew/core)" remote set-url origin https://github.com/Homebrew/homebrew-core.git

# 重置 homebrew-cask.git
git -C "$(brew --repo homebrew/cask)" remote set-url origin https://github.com/Homebrew/homebrew-cask.git

同时把 ~/.zshrc 里的 HOMEBREW 环境变量注释掉或删掉，source 之后 brew update 一下就能切回官方源。

总结

Homebrew 是 macOS 开发者几乎绕不开的工具，安装一次受益终身。从多种安装方式中选择最适合你的那条，国内用户强烈推荐镜像安装脚本，装好之后第一时间配置国内镜像源，速度差真的很大。

日常使用 Homebrew 只需要记住 brew install（装工具）、brew install --cask（装应用）、brew update/upgrade（更新）、brew doctor（排错）这几条命令就够了。跟着上面的步骤走完，你的 Mac 就拥有了一个强大的包管理器，以后装开发软件再也不用到处找安装包了。