2026实测:Homebrew安装+配置国内源+使用一篇搞定(多种安装方式)

作者:袖梨 2026-07-18

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


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


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


工具平台核心定位软件来源图形界面应用HomebrewmacOS / Linux通用包管理Formula + Cask✓ brew install --caskMacPortsmacOS类Unix包管理Portfile部分支持SpackLinux / macOS科学计算包管理Package recipe✗APT (Linux)Linux 发行版系统包管理Debian 仓库✓","rows":5,"cols":5,"id":"5ujcT"}">


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

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


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

安装Homebrew

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

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

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


下载 homebrew.pkg 安装包:homebrew.pkg(源自 Github,放心使用)


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


img_6a5b44c2f233530.webp


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

2)脚本安装Homebrew

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

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

① 国内镜像安装Homebrew

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

输入命令后会提示输入序号,比如选择 1:


img_6a5b44c2f233b31.webp


继续输入电脑密码:


img_6a5b44c2f233e32.webp


输入 y:


img_6a5b44c2f234033.webp


按回车键继续:


img_6a5b44c2f234234.webp


再次输入密码:


img_6a5b44c2f234435.webp


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


img_6a5b44c2f234636.webp

② 官方脚本安装Homebrew

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

③ Git 克隆安装

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

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

验证安装Homebrew

安装完成后,终端输入 brew --version 查看版本号,如果显示了版本号(格式为:Homebrew  x.x.x)说明 Homebrew 安装成功:


img_6a5b44c2f234937.webp


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

Homebrew配置国内镜像源

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


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


中科大镜像源:


清华大学镜像源:


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

保存退出后 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 环境,排错神器,遇到报错先跑这个","rows":11,"cols":3,"id":"7xX6S"}">


还有一些进阶小技巧:

如果不想某个软件被升级,可以用 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 官方地址:

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

总结

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


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

相关文章

精彩推荐