Homebrew 是 macOS(以及 Linux)上一个极其流行的包管理工具。你可以把它形象地理解为一个"命令行应用商店"。
它的核心使命是解决在 macOS 上安装、更新和管理软件的繁琐问题,因此被誉为 "macOS 缺失的包管理器" (The missing package manager for macOS)。
一、前言介绍
为什么需要 Homebrew?
在没有 Homebrew 的时代,在 macOS 上管理开发工具(如 Git, Python, Node.js)通常很麻烦:
- 下载麻烦:需要去各个软件官网寻找安装包。
- 依赖复杂:软件依赖的其他库需要手动安装和配置。
- 管理困难:升级和卸载软件容易残留文件,难以追踪。
Homebrew 彻底改变了这一现状,通过简单的命令(如 brew install git)就能自动完成下载、解决依赖、编译安装和路径配置,极大地提升了开发者效率。
二、核心概念
Homebrew 的设计非常直观,主要包含以下几个核心概念:
- Formula (公式) :用于安装命令行工具和库。例如,通过
brew install python安装 Python 环境。 - Cask (桶) :用于安装带有图形界面(GUI)的 macOS 应用程序。例如,通过
brew install --cask visual-studio-code安装 VS Code。 - Tap (第三方仓库):一个扩展机制,允许你添加第三方软件源,获取更多官方仓库没有的软件。
三、下载安装

bash
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
上述指令是下载位于 GitHub 上的安装脚本。
如果不能正常下载或者下载缓慢,使用下述的国内清华源安装脚本:
bash
/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"
键盘 command + 空格 进入搜索 搜索 终端并打开,接着粘贴上述指令。
输入指令后会出现 Password 字样直接输入你的电脑密码点击回车,便会自动下载。

出现下述 下载 XCode 字样,继续回车即可。


四、验证安装
bash
brew --version
出现版本号即安装成功:

五、切换国内镜像
由于 Homebrew 的软件源位于 GitHub,国内用户直接使用可能会遇到下载缓慢或失败的问题。强烈建议更换为国内镜像源,这能显著提升安装速度和成功率。
输入下述指令可以查看当前源:
bash
git -C "$(brew --repo)" remote -v
我的源是github:

这里我推荐清华源,切换镜像源示例 (以清华大学源为例),切换镜像源的本质是修改其背后 Git 仓库的远程地址。
打开终端配置文件
macOS 默认使用 zsh,因此我们需要编辑 ~/.zshrc 文件。
nano ~/.zshrc

添加清华源配置
在文件末尾添加以下三行配置:
# 设置 Homebrew 核心仓库、API 和二进制包的镜像源为清华大学镜像站
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"


使配置立即生效
保存并退出编辑器(在 nano 中按 Ctrl + O 保存,然后 Ctrl + X 退出),然后执行以下命令让配置生效:
source ~/.zshrc

更新 Homebrew
最后,运行 brew update 来应用新的源配置。首次更新可能会稍慢,因为它需要从新源拉取数据。
brew update

再次查看源就可以发现更改成功
bash
git -C "$(brew --repo)" remote -v

六、常用指令
掌握了这些常用命令,你就能像专家一样高效管理 macOS 上的软件了。
以下是最核心、最常用的 Homebrew 命令速查表,涵盖了日常使用的方方面面:
6.1 核心常用命令速查表
| 操作类别 | 命令格式 | 说明 |
|---|---|---|
| 安装 | brew install <软件名> |
安装命令行工具(如 git, wget) |
| 安装 GUI | brew install --cask <软件名> |
安装图形界面应用(如 visual-studio-code) |
| 搜索 | brew search <关键词> |
搜索可用的软件包 |
| 更新 | brew update |
更新 Homebrew 自身及软件列表 |
| 升级 | brew upgrade |
升级 所有已安装的软件到最新版 |
| 卸载 | brew uninstall <软件名> |
卸载指定软件 |
| 列表 | brew list |
查看已安装的软件列表 |
| 信息 | brew info <软件名> |
查看软件的详细信息(版本、依赖等) |
| 诊断 | brew doctor |
检查系统环境是否存在问题(排错神器) |
6.2 详细命令分类解析
6.2.1 搜索与发现 (search, info)
在安装之前,通常需要先确认软件是否存在或查看其详情。
-
搜索软件 :
brew search google brew search python -
查看软件信息 :
brew info git输出会显示:当前版本、是否已安装、依赖关系、安装路径等。
6.2.2 安装与卸载 (install, uninstall)
这是最常用的功能。Homebrew 分为 Formula (命令行工具)和 Cask(图形界面应用)。
-
安装命令行工具 (Formula):
brew install wget brew install node@18 # 安装指定版本 -
安装图形界面应用 (Cask):
brew install --cask google-chrome brew install --cask visual-studio-code -
卸载软件 :
brew uninstall wget brew uninstall --cask google-chrome # 卸载图形应用需带上 --cask
6.2.3 更新与升级 (update, upgrade)
新手容易混淆这两个概念,记住这个口诀:
-
update:去应用商店刷新货架(更新软件列表)。 -
upgrade:把家里已有的旧东西换成新东西(升级已安装软件)。 -
更新软件列表:
brew update -
升级所有软件:
brew upgrade -
升级指定软件:
brew upgrade git
6.2.4 状态与清理 (list, cleanup, outdated)
保持系统整洁。
-
列出已安装软件 :
brew list # 列出命令行工具 brew list --cask # 仅列出图形界面应用 -
查看可升级的软件 :
brew outdated -
清理缓存 (释放磁盘空间):
brew cleanup这会删除旧版本的安装包和缓存文件。
6.2.5 诊断与帮助 (doctor, help)
-
诊断环境问题 :
brew doctor如果遇到安装报错,先运行这个命令,它会给出非常具体的修复建议。
-
查看帮助 :
brew help brew help install # 查看 install 命令的详细用法
6.2.5 进阶小贴士
-
锁定版本 :如果你不希望某个软件在
upgrade时被更新,可以将其锁定:brew pin git # 锁定 git brew unpin git # 解锁 -
查看依赖树 :
brew deps --installed --tree查看已安装软件的依赖关系,非常直观。