首页 2026 Homebrew 安装配置与常用命令详解(4种方式,附安装包)

2026 Homebrew 安装配置与常用命令详解(4种方式,附安装包)

更新于 2026-09-29

Homebrew 是什么,能解决什么问题

Homebrew 是一款运行在 macOS 和 Linux 上的软件包管理器,通俗点说就是一个”软件安装管家”。平时在 Mac 上装软件,要么去官网找安装包,要么去 App Store 搜索,Homebrew 改变了这种方式:在终端里输入一条命令,软件就会自动下载、安装、配置好,连依赖一起处理,卸载时也是一条命令清干净。

和 Homebrew 类似的包管理器还有不少,macOS 上有老牌的 MacPorts,Windows 上有系统自带的 winget,Linux 上有 apt、yum。Homebrew 之所以在 Mac 用户里很流行,是因为它安装简单、软件库全、日常使用几乎不用折腾。

Homebrew 安装包下载方式

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

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

Homebrew 安装步骤详解

本文覆盖 4 种安装方式,全程实测,确保不会踩坑。

方式一:下载 pkg 安装包(新手推荐,系统版本至少 macOS 14)

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

  1. 下载 homebrew.pkg 安装包:夸克网盘下载
  2. 直接双击 homebrew.pkg 打开,安装向导会自动引导完成安装:
  3. 和装其他 macOS 软件一样,一路继续就行。安装完成后 Homebrew 会自动安装到默认路径,Apple Silicon 芯片的 Mac 装到 /opt/homebrew,Intel 芯片的 Mac 装到 /usr/local。

方式二:脚本安装(3 种方式)

安装 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 —version查看 Homebrew 版本安装后先用它验证是否成功
brew search 软件名搜索软件不确定软件在不在库中时先用它
brew install 软件名安装命令行工具最常用的命令,依赖自动处理
brew install —cask 软件名安装图形界面应用装 App 用,如 brew install —cask google-chrome
brew list查看已装软件列出所有命令行工具
brew list —cask查看已装图形应用只列 cask 安装的应用
brew update更新 Homebrew 和软件索引装软件前建议先跑一遍
brew upgrade升级全部软件只升一个用 brew upgrade 软件名
brew uninstall 软件名卸载软件卸载命令行工具
brew uninstall —cask 软件名卸载图形应用对应 cask 安装的应用
brew autoremove清理卸载残留的依赖卸载后跑一遍,清掉孤立依赖
brew info 软件名查看软件详情版本、依赖、安装路径等信息
brew cleanup清理旧版本和缓存定期执行,释放磁盘空间
brew doctor检查环境问题遇到问题先跑它,会给出修复建议
brew services list查看后台服务列出用 brew 管理的服务
brew services start 服务名启动后台服务如 mysql、redis 等常驻服务
brew services stop 服务名停止后台服务停止对应的常驻服务
brew —prefix显示 Homebrew 安装路径查看 brew 装在哪个目录

使用注意事项:

  • 平时能双击打开、有窗口界面的软件(比如 Chrome 浏览器、微信),安装时加 —cask;只能在终端里敲命令使用、没有窗口的小工具(比如 wget),直接 install 就行。
  • brew cleanup 只清理 Homebrew 自己的旧版本和下载缓存,不会动个人文件,可以放心定期执行。
  • 如果不想某个软件被升级,可以用 brew pin 软件名 锁定版本,brew unpin 软件名 解锁。
  • 用 brew deps --installed --tree 可以查看当前已装软件的依赖关系树,对自己装了什么东西很清楚。

常见问题

问:Homebrew 安装后如何确认是否成功?

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

问:为什么建议安装后配置国内镜像源?

答:安装完成后不配置国内镜像源,后面装软件会非常慢,换成中科大或清华的镜像源后,下载速度会明显提升。

问:安装时提示需要 Command Line Tools 怎么办?

答:安装 Homebrew 前需要先安装 Command Line Tools,在终端里输入 xcode-select --install,执行后等待弹窗点击”安装”完成即可,这一步是必须的。