macOS Homebrew 完全指南：安装、换源与核心命令速查

macOS Homebrew 完全指南

Homebrew 是 macOS（以及 Linux）上一个极其流行的包管理工具，可以形象地理解为一个'命令行应用商店'。它的核心使命是解决在 macOS 上安装、更新和管理软件的繁琐问题，被誉为'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 (第三方仓库)：一个扩展机制，允许你添加第三方软件源，获取更多官方仓库没有的软件。

三、下载安装

官网：https://brew.sh/zh-cn/

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

上述指令是下载位于 GitHub 上的安装脚本。

如果不能正常下载或者下载缓慢，使用下述的国内清华源安装脚本：

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

打开终端并粘贴上述指令。输入指令后会出现 Password 字样，直接输入电脑密码点击回车，便会自动下载。

出现提示要求下载 XCode 时，继续回车即可。

四、验证安装

brew --version

出现版本号即安装成功。

五、切换国内镜像

由于 Homebrew 的软件源位于 GitHub，国内用户直接使用可能会遇到下载缓慢或失败的问题。强烈建议更换为国内镜像源，这能显著提升安装速度和成功率。

输入下述指令可以查看当前源：

git -C "$(brew --repo)" remote -v

这里推荐清华源，切换镜像源示例如下（以清华大学源为例），切换镜像源的本质是修改其背后 Git 仓库的远程地址。

5.1 替换主仓库

替换 brew.git 仓库

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

接着更新：

brew update

5.2 可选替代

下述操作需要你已经用 Homebrew 下载安装过软件后才可以执行，不然会出现文件不存在的情况。

为什么会出现这种情况？

Tap 机制：Homebrew 将软件分成了不同的'桶'（Taps）。
- homebrew/cask：管理图形界面软件（你之前可能用过，所以它存在）。
- homebrew/core：管理命令行工具（你没用过，所以它被'懒加载'了）。
Update 的逻辑：brew update 默认只更新已经安装（Initialized）的 Taps。因为 core 还没被初始化，所以 update 跳过了它。

所以需要你之后下载过必要软件之后再来执行下述命令，可以替换镜像源。

替换 homebrew-core 仓库

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

替换 homebrew-cask 仓库 (用于图形应用)

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

六、常用指令

掌握了这些常用命令，你就能像专家一样高效管理 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 info git

输出会显示：当前版本、是否已安装、依赖关系、安装路径等。

搜索软件：

brew search google
brew search python

6.2.2 安装与卸载 (`install`, `uninstall`)

这是最常用的功能。Homebrew 分为 Formula（命令行工具）和 Cask（图形界面应用）。

卸载软件：

brew uninstall wget
brew uninstall --cask google-chrome # 卸载图形应用需带上 --cask

安装图形界面应用 (Cask)：

brew install --cask google-chrome
brew install --cask visual-studio-code

安装命令行工具 (Formula)：

brew install wget
brew install node@18 # 安装指定版本

6.2.3 更新与升级 (`update`, `upgrade`)

新手容易混淆这两个概念，记住这个口诀：

update：去应用商店刷新货架（更新软件列表）。
upgrade：把家里已有的旧东西换成新东西（升级已安装软件）。

升级指定软件：

brew upgrade git

升级所有软件：

brew upgrade

更新软件列表：

brew update

6.2.4 状态与清理 (`list`, `cleanup`, `outdated`)

保持系统整洁。

清理缓存（释放磁盘空间）：

brew cleanup

这会删除旧版本的安装包和缓存文件。

查看可升级的软件：

brew outdated

列出已安装软件：

brew list # 列出命令行工具
brew list --cask # 仅列出图形界面应用

6.2.5 诊断与帮助 (`doctor`, `help`)

查看帮助：

brew help
brew help install # 查看 install 命令的详细用法

诊断环境问题：

brew doctor

如果遇到安装报错，先运行这个命令，它会给出非常具体的修复建议。

6.2.6 进阶小贴士

查看依赖树：

brew deps --installed --tree

查看已安装软件的依赖关系，非常直观。

锁定版本：如果你不希望某个软件在 upgrade 时被更新，可以将其锁定：

brew pin git # 锁定 git
brew unpin git # 解锁

macOS Homebrew 完全指南：安装、换源与核心命令速查