Homebrew 完全使用手册（中文教程）

适用版本：Homebrew 4.x 及以上
适用平台：macOS、Apple Silicon（M1/M2/M3）、Linux（包括 WSL）
文档性质：教程式完整手册，适合从零开始到进阶使用
最后更新：2024 年

📖 目录

• 一、认识 Homebrew
• 二、安装 Homebrew
• 三、核心概念
• 四、基础使用
• 五、查找与探索软件
• 六、安装与管理软件
• 七、服务管理（Services）
• 八、升级与维护
• 九、清理与优化
• 十、进阶用法：Tap（第三方源）
• 十一、进阶用法：Cask（图形应用）
• 十二、编写自己的 Formula
• 十三、环境变量与配置
• 十四、常见问题排查
• 十五、最佳实践与技巧
• 附录：命令速查表

一、认识 Homebrew

1.1 什么是 Homebrew？

Homebrew（俗称"brew"）是 macOS 和 Linux 上最流行的开源包管理器。你可以把它想象成一个"应用商店"，但它是通过命令行操作的，而且是完全开源、免费的。

它的核心理念只有一句话：

"Install things, not apps. Install packages, not the things inside them."
（安装东西本身，而不是安装"应用"这个抽象概念。安装包，而不是包里面装的那些东西。）

简单说，Homebrew 帮你：

• ✅ 自动下载软件及其所有依赖
• ✅ 把软件安装到统一的目录（避免污染系统）
• ✅ 一条命令更新所有软件
• ✅ 一条命令卸载干净（不留垃圾）
• ✅ 让你的开发环境保持一致、可复现

1.2 为什么需要 Homebrew？

在没有包管理器之前，在 macOS/Linux 上安装软件意味着：

1. 去官网下载 .dmg 或 .tar.gz
2. 手动拖到 /Applications 或编译安装
3. 依赖冲突、版本错乱、卸载不干净

Homebrew 把这一切自动化了。你只需要：

brew install wget

就能装好 wget 及其所有依赖，并且随时可以：

brew upgrade wget    # 升级
brew uninstall wget  # 卸载

1.3 Homebrew 的组成

Homebrew 并不是一个单一的工具，它由几个"子项目"组成：

1.4 适合谁用？

• 🧑‍💻 开发者：装编程语言、数据库、CLI 工具
• 🔬 科研/数据：装 Python、R、计算工具
• 🎨 设计师：装图形软件（Cask）
• 🛠️ 运维：装服务器软件
• 🏠 普通用户：也能用 Cask 一键装 Chrome、VSCode 等

二、安装 Homebrew

2.1 系统要求

• macOS：10.15 (Catalina) 或更高（推荐最新的 macOS）
• Linux：Ubuntu、Debian、Fedora、CentOS、Arch 等主流发行版
• 命令行工具：需要 bash、git、curl（一般自带）
• Apple Silicon 注意：M1/M2/M3 芯片用户需要先装 Xcode Command Line Tools

2.2 安装前准备（仅 macOS）

先装好 Xcode Command Line Tools，里面有 git、make、gcc 等基础工具：

xcode-select --install

弹出窗口后点"安装"，等几分钟即可。

2.3 一键安装

在终端（Terminal.app 或 iTerm2）执行：

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

💡 小贴士：这条命令会自动：

1. 下载安装脚本
2. 提示你按 Return（回车）确认
3. 创建 /opt/homebrew（Apple Silicon）或 /usr/local（Intel）目录
4. 配置环境变量

2.4 安装后的配置

macOS（Apple Silicon，M1/M2/M3）

打开 ~/.zprofile（或 ~/.bash_profile，取决于你用的 shell）：

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

macOS（Intel）

echo 'eval "$(/usr/local/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/usr/local/bin/brew shellenv)"

Linux（使用 Linuxbrew）

参考 官方 Linux 安装指南。

2.5 验证安装

brew --version

看到类似下面的输出就说明成功了：

Homebrew 4.x.x

进一步验证：

brew doctor

⚠️ brew doctor 会"挑刺"地检查你的环境。如果有警告，按提示修复即可，新手可以先忽略非关键警告。

三、核心概念

理解这几个概念，你就能熟练驾驭 Homebrew 了。

3.1 Formula（配方）

Formula 是用 Ruby 写的"安装脚本"，定义了如何下载、编译、安装一个命令行工具。

例如 wget 的 Formula 描述了：

• 去哪里下载源码（URL）
• 源码的校验和（SHA256）
• 依赖什么其他包（Dependencies）
• 如何编译（Build instructions）

你不需要写 Formula 就能用 Homebrew，但了解它能帮你理解背后的工作原理。

一个 Formula 对应一个命令行工具或后台程序。

3.2 Cask（木桶）

Cask 是 Formula 的扩展，专门用于安装 macOS 图形界面应用，比如 Chrome、VSCode、Slack。

Cask 不会编译源码，它只是把 .app 下载下来放到 /Applications（或 ~/Applications）。

一个 Cask 对应一个图形界面应用（.app）。

3.3 Tap（水龙头）

Tap 是 Formula 和 Cask 的集合，本质上是一个 Git 仓库。

默认你只能装 homebrew/core 里的软件（已经非常多，几千个）。通过 brew tap，你可以接入第三方仓库，比如：

• homebrew/cask：图形应用
• homebrew/services：服务管理
• 你自己公司的内部 Tap

3.4 Cellar（酒窖）

Cellar 是 Homebrew 安装所有软件的地方：

• Apple Silicon：/opt/homebrew/Cellar/
• Intel：/usr/local/Cellar/

每个软件一个独立目录，互不干扰。这种"沙箱"思想是 Homebrew 的精髓——安装的软件不会污染你的系统。

3.5 Keg（小桶）

Keg 是 Cellar 里的单个软件目录。例如：

/opt/homebrew/Cellar/
├── wget/
│   └── 1.21.4/        # 这就是一个 Keg（具体版本）
├── python@
│   ├── 3.11.5/
│   └── 3.12.0/

Homebrew 支持多版本共存，旧版本不会被自动删除。

3.6 软链接（Symlinks）

软件真正可执行的文件在 Cellar 里，但你在终端敲 wget 时怎么找到它？

Homebrew 把所有可执行文件软链接到：

• Apple Silicon：/opt/homebrew/bin/
• Intel：/usr/local/bin/

这就是为什么安装后你需要把 Homebrew 的 bin 目录加到 PATH 里。

四、基础使用

4.1 安装第一个软件

试试安装 wget（一个下载工具）：

brew install wget

执行过程：

1. 自动下载 Formula（wget.rb）
2. 检查依赖（这里几乎没有）
3. 下载源码包
4. 编译（或解压预编译二进制）
5. 安装到 Cellar
6. 创建软链接到 bin 目录

完成后试试：

wget --version

4.2 更新 Homebrew 本身

Homebrew 本身也是一个 Git 仓库，需要定期拉取最新版本：

brew update

💡 强烈建议：每次 brew install 或 brew upgrade 前先 brew update，否则可能装不到最新版。

4.3 查看已安装的软件

brew list            # 所有 Formula
brew list --cask     # 所有 Cask（图形应用）
brew list --versions # 显示版本号

输出类似：

wget        1.21.4
python@3.11 3.11.5
git         2.43.0

4.4 卸载软件

brew uninstall wget

干净利落，不留垃圾。

4.5 查看软件信息

brew info wget

输出包括：

• 最新版本号
• 依赖
• 仓库地址
• 当前是否已安装、什么版本
• 是否有"keg-only"标识（见下文）

4.6 搜索软件

brew search <关键词>

例如：

brew search python

会列出所有名字或描述里含 "python" 的 Formula 和 Cask。

💡 提示：brew search 默认同时搜索 Formula 和 Cask。如果只想搜 Formula，加 --formula；只想搜 Cask，加 --cask。

五、查找与探索软件

Homebrew 仓库（homebrew/core）有 7000+ Formula，4000+ Cask。怎么找到你想要的那个？

5.1 用命令行搜索

brew search <keyword>

支持正则，例如：

brew search /^node/

搜所有以 node 开头的包。

5.2 用官网搜索

浏览器打开 https://formulae.brew.sh

• 左栏搜 Formula（命令行工具）
• 右栏搜 Cask（图形应用）

可以按"最常用"、"最近更新"、"下载量"排序。

5.3 查看软件详情

brew info <name>

更详细的信息（包含所有版本历史）：

brew info --json=v2 <name>

5.4 查看 Formula 源码

想知道 wget 是怎么安装的？

brew cat wget

会打印 Formula 的 Ruby 源码。

5.5 看软件的依赖关系

brew deps wget

输出：

openssl@3
libidn2

表示 wget 依赖 openssl@3 和 libidn2。Homebrew 会自动帮你装上。

反向依赖（谁依赖我）：

brew uses openssl@3

六、安装与管理软件

6.1 安装最新版本

brew install <name>

6.2 安装指定版本

有时你需要特定版本（比如 python@3.10）：

brew install python@3.10

如果想装的版本在 Formula 里没有，Homebrew 提供了"按版本号"搜索：

brew search python@

列出所有 python@3.x 版本。

⚠️ 不是所有软件都支持多版本。可以用 brew info <name> 看是否有 @版本号 后缀。

6.3 切换版本

如果同时装了 python@3.10 和 python@3.11，怎么用其中一个？

方法 1：直接用版本化命令

python3.10 --version
python3.11 --version

方法 2：临时切换 PATH

export PATH="/opt/homebrew/opt/python@3.10/bin:$PATH"

方法 3：使用 brew link --force

brew unlink python@3.11
brew link python@3.10

⚠️ 同一时间只能 link 一个版本。

6.4 重新安装

如果某个软件坏了，重新装：

brew reinstall <name>

它会先卸载再装，比手动 uninstall + install 更快。

6.5 锁定版本（不想被升级）

brew pin <name>

锁定后，brew upgrade 会跳过该软件。

解除锁定：

brew unpin <name>

6.6 了解 keg-only 软件

brew info <name>

如果看到 Keg-only 字样，意思是：Homebrew 装了这个软件，但没有把它链接到 /opt/homebrew/bin。

原因一般是：与 macOS 自带版本冲突（典型例子：python、openssl、git）。

解决方案：

brew link --force <name>     # 强制链接（覆盖系统版本）
brew unlink <name>           # 取消链接，恢复系统版本

6.7 安装时附带编译选项

某些 Formula 支持"编译选项"（build options）。例如 python 支持 --with-pydebug：

brew install python --with-pydebug

查看可用选项：

brew info <name>

会列出所有 --with-xxx。

七、服务管理（Services）

如果装了 redis、postgres、nginx 这类需要后台运行的软件，Homebrew 提供了简单的服务管理。

7.1 安装 services 子命令

brew tap homebrew/services

（新版 Homebrew 已默认包含，无需手动安装）

7.2 启动服务

brew services start redis

这会用 launchd（macOS）或 systemd（Linux）启动它，并设置开机自启。

7.3 查看服务状态

brew services list

输出：

Name       Status  User    File
redis      started user    ~/Library/LaunchAgents/homebrew.mxcl.redis.plist
mysql      stopped
nginx      started user    ~/Library/LaunchAgents/homebrew.mxcl.nginx.plist

7.4 停止与重启

brew services stop redis
brew services restart redis

7.5 临时运行（不开机自启）

brew services run redis

run 启动但不注册为守护进程，关闭终端窗口就会停。

7.6 常用的服务类软件

• 数据库：mysql、postgresql@14、redis、mongodb-community
• Web 服务器：nginx、httpd
• 消息队列：rabbitmq、kafka
• 搜索：elasticsearch

八、升级与维护

8.1 升级 Homebrew 自身

brew update

8.2 升级所有软件

brew upgrade

8.3 升级指定软件

brew upgrade wget

8.4 查看可升级的软件

brew outdated

8.5 升级是否影响服务的提示

升级 postgresql、redis 这类软件时，会提示你需要重启服务。重启：

brew services restart postgresql

8.6 自动清理过期版本

brew cleanup

删除旧版本，释放空间。

自动清理（强制）：

brew cleanup -s

-s 还会清理所有缓存下载包。

设置自动清理（推荐）：

brew autoupdate start

这会创建一个定时任务，每天自动 brew update && brew upgrade && brew cleanup。

停止自动清理：

brew autoupdate stop

九、清理与优化

Homebrew 用久了会积累大量旧版本和下载缓存。定期清理很重要。

9.1 查看占用空间

brew info --disk-usage

或：

du -sh /opt/homebrew/Cellar

9.2 清理下载缓存

brew cleanup

清理所有超过 120 天的下载文件，更彻底：

brew cleanup --prune=all -s

9.3 删除孤儿依赖

你卸载了一个软件，它的依赖可能还在：

brew autoremove

💡 Homebrew 会标记"被 Formula 显式依赖"的包为"required"，autoremove 只删那些没用的。

9.4 验证安装完整性

brew doctor

doctor 会检查：

• 系统环境
• 权限
• 软链接
• 常见配置错误

新手第一次跑可能会看到一堆警告，但绝大多数不影响使用。

9.5 加速下载（中国用户）

默认从 GitHub 下载，国内可能很慢。可以设置镜像：

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

写到 ~/.zshrc 或 ~/.zprofile 里持久生效。

常用镜像：

• 中科大：https://mirrors.ustc.edu.cn/
• 清华：https://mirrors.tuna.tsinghua.edu.cn/
• 阿里：https://mirrors.aliyun.com/homebrew/

十、进阶用法：Tap（第三方源）

10.1 什么是 Tap？

Tap 是第三方 Formula/Cask 仓库。默认你只能用 homebrew/core 和 homebrew/cask，但通过 Tap 你可以接入无数社区贡献的源。

10.2 添加 Tap

brew tap <user>/<repo>

例如：

brew tap mongodb/brew

这会把 https://github.com/mongodb/homebrew-brew 添加为 Tap，之后可以装 mongodb-community。

10.3 常用 Tap 推荐

10.4 列出已添加的 Tap

brew tap

10.5 删除 Tap

brew untap <user>/<repo>

10.6 创建自己的 Tap

1. 在 GitHub 创建一个仓库，比如 yourname/homebrew-tap
2. 把 Formula 放进去（Formula/wget.rb）
3. brew tap yourname/tap

这样别人就可以通过 brew install yourname/tap/wget 装你的软件了。

十一、进阶用法：Cask（图形应用）

Cask 是 Homebrew 安装 macOS 图形应用的标准方式。

11.1 启用 Cask

新版 Homebrew 已默认集成 Cask 子命令，无需额外安装。如果要更新：

brew tap homebrew/cask
brew update

11.2 安装图形应用

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

应用会安装到 /Applications（需要管理员密码）。

💡 也可以装到 ~/Applications（不需要管理员密码）：

brew install --cask <name> --appdir=~/Applications

11.3 搜索 Cask

brew search --cask <关键词>

例如：

brew search --cask video

11.4 常用 Cask 推荐

11.5 卸载 Cask

brew uninstall --cask google-chrome

干净卸载，会一并清理相关配置文件（在 ~/Library/Application Support 等）。

11.6 安装带后缀的旧版本

brew tap homebrew/cask-versions
brew install --cask firefox-esr
brew install --cask java8

11.7 Cask 的限制

• Cask 仅适用于 macOS（Linux 上基本不可用）
• 不支持 App Store 应用
• 部分应用可能因为 Apple 签名问题装不上

十二、编写自己的 Formula

当你写了一个命令行工具想发布给别人用，写一个 Homebrew Formula 是最优雅的发布方式。

12.1 Formula 的位置

Formula 存放在 homebrew/core（官方）或自己的 Tap（个人/团队）中。

每个 Formula 是一个 Ruby 文件，描述：

• 软件名字、版本
• 下载地址、校验码
• 依赖
• 安装方式

12.2 一个最简单的 Formula

文件名：Formula/wget.rb（这里以 wget 为例）

class Wget < Formula
  desc "Internet file retriever"
  homepage "https://www.gnu.org/software/wget/"
  url "https://ftp.gnu.org/gnu/wget/wget-1.21.4.tar.gz"
  sha256 "a6e1de32f5c4840ec38c85327d23a6b8214820a4dc9c9f8a878a4490b9f6d9c0"
  license "GPL-3.0-or-later"

  depends_on "openssl@3"
  depends_on "libidn2"

  def install
    system "./configure", *std_configure_args,
                          "--with-ssl=openssl"
    system "make", "install"
  end

  test do
    system bin/"wget", "--version"
  end
end

12.3 Formula 各部分详解

class Wget < Formula           # 类名 = 软件名（首字母大写）
  desc "..."                   # 简短描述（一行）
  homepage "..."               # 项目主页
  url "..."                    # 源码下载地址
  sha256 "..."                 # 源码 SHA256 校验码
  license "..."                # 许可证（SPDX 标识符）
  
  depends_on "xxx"             # 编译/运行依赖
  uses_from_macos "xxx"        # 用系统自带的依赖
  
  # 可选：构建选项
  option "with-foo", "Enable foo feature"
  
  # 安装逻辑
  def install
    # 这里是真正的安装脚本
  end
  
  # 测试逻辑
  test do
    # 安装后跑这个测试验证
  end
end

12.4 常用 depends_on 类型

depends_on "cmake"              # Formula 依赖
depends_on "python@3.11"        # 带版本的 Formula 依赖
depends_on :macos               # 限定 macOS 版本
depends_on :xcode               # 需要 Xcode
depends_on :arch => :arm64      # 限定架构

12.5 安装模式

模式 1：从源码编译（最常见）

def install
  system "./configure", "--prefix=#{prefix}"
  system "make", "install"
end

模式 2：预编译二进制（Bottle）

def install
  bin.install "wget"   # 把 wget 文件放到 bin 目录
end

模式 3：Go/Rust 单文件二进制

def install
  bin.install "myapp"
end

12.6 调试 Formula

brew install --debug <formula>
brew install --verbose <formula>

进入交互式 Ruby 调试器或在编译失败时保留中间文件。

12.7 提交到 homebrew/core

1. Fork homebrew-core
2. 新建分支，添加 Formula/<name>.rb
3. brew audit --new <name> 检查格式
4. brew style <name> 检查风格
5. 提交 PR，等待 maintainer 审核

⚠️ homebrew/core 有严格的质量要求，新 Formula 必须稳定且非"个人玩具"项目。

十三、环境变量与配置

13.1 Homebrew 的关键环境变量

13.2 修改镜像源（中国用户必看）

写入 ~/.zshrc 或 ~/.zprofile：

# 中科大镜像
export HOMEBREW_API_DOMAIN="https://mirrors.ustc.edu.cn/homebrew-bottles/api"
export HOMEBREW_BOTTLE_DOMAIN="https://mirrors.ustc.edu.cn/homebrew-bottles"
export HOMEBREW_BREW_GIT_REMOTE="https://mirrors.ustc.edu.cn/brew.git"
export HOMEBREW_CORE_GIT_REMOTE="https://mirrors.ustc.edu.cn/homebrew-core.git"

然后 source ~/.zshrc 生效。

13.3 关闭分析统计

export HOMEBREW_NO_ANALYTICS=1

13.4 临时关闭自动更新

HOMEBREW_NO_AUTO_UPDATE=1 brew install xxx

13.5 自定义 Cellar 路径

不建议修改，但可以做到：

export HOMEBREW_CELLAR=/custom/path/Cellar

十四、常见问题排查

14.1 brew install 失败：Permission denied

原因：权限问题。

解决：

sudo chown -R $(whoami) $(brew --prefix)/*

14.2 brew install 失败：checksum mismatch

原因：下载文件损坏或被篡改。

解决：

brew update
brew install <name>

如果还不行：

rm -rf $(brew --cache)

清理下载缓存后重试。

14.3 找不到刚装的命令

原因：PATH 没配置好。

解决：

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
source ~/.zprofile

或者：

export PATH="/opt/homebrew/bin:$PATH"

14.4 安装很慢

原因：默认从 GitHub 下载，国内慢。

解决：配置镜像源（见 13.2）。

14.5 brew doctor 警告太多

brew doctor 会很挑剔，但很多警告是"建议级别"，不影响使用。可以选择性关注：

• ⚠️ 黄色警告：可以忽略
• ❌ 红色错误：必须处理

14.6 卸载后软件还在

brew uninstall 默认不清理配置文件。如果要彻底清除：

brew uninstall --zap <cask-name>

--zap 会删除相关缓存和配置文件（仅 Cask 支持）。

14.7 Apple Silicon 上装 x86 软件

有些软件还没适配 ARM，需要通过 Rosetta 运行：

arch -x86_64 brew install <name>

14.8 同一个软件装了两份

brew list --versions <name>

看到多个版本说明都有。如果只想留一个：

brew uninstall <name>@<version>

14.9 brew services start 失败

原因：服务对应的 plist 文件有问题。

解决：

brew services stop <name>
brew services start <name>

或重新装：

brew reinstall <name>
brew services start <name>

14.10 升级后某个软件坏了

降级到上一个版本：

brew pin <name>     # 先 pin 住，避免再升级
brew uninstall <name>
brew install <name>@<old-version>

十五、最佳实践与技巧

15.1 用 Homebrew Bundle 描述整套环境

Brewfile 类似 package.json，记录你装的所有软件。新机器上一行命令就能恢复环境：

# 当前机器导出 Brewfile
brew bundle dump

# 生成 Brewfile 文件
cat Brewfile

内容示例：

tap "homebrew/cask"
tap "mongodb/brew"

brew "git"
brew "wget"
brew "python@3.11"
brew "node"

cask "google-chrome"
cask "visual-studio-code"
cask "docker"

在新机器上恢复：

brew bundle install

💡 把 Brewfile 提交到 Git 仓库，团队成员共用一套开发环境。

15.2 一键搭建开发环境

把初始化脚本写成：

#!/bin/bash
# setup.sh

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

# 配置镜像（可选）
export HOMEBREW_API_DOMAIN="https://mirrors.ustc.edu.cn/homebrew-bottles/api"
export HOMEBREW_BOTTLE_DOMAIN="https://mirrors.ustc.edu.cn/homebrew-bottles"

# 装所有依赖
brew bundle install

新同事入职一行命令搞定。

15.3 自动更新和清理

brew autoupdate start --upgrade --cleanup

每天自动 update + upgrade + cleanup。

15.4 谨慎使用 brew upgrade

brew upgrade 会一次性升级所有包，可能导致兼容性问题。建议：

• 经常 brew outdated 看变化
• 重大升级前先在测试环境验证
• 重要的开发工具用 brew pin 锁住

15.5 用 brew search --desc 精准搜索

brew search --desc "video player"

按描述搜索，比按名字搜索更精准。

15.6 离线安装：Bottle

Homebrew 默认下载预编译二进制（"Bottle"），速度很快。如果你想强制源码编译：

brew install --build-from-source <name>

15.7 查看命令历史

brew commands | less

列出所有可用子命令。

15.8 推荐的"必装"清单

开发者基础：

brew install git
brew install wget
brew install curl
brew install jq
brew install yq
brew install ripgrep     # 更快 grep
brew install fd          # 更快 find
brew install fzf         # 模糊搜索
brew install bat         # 带高亮的 cat
brew install eza         # 更好看的 ls
brew install htop        # 进程管理
brew install tmux        # 终端复用
brew install starship    # 漂亮的 shell prompt

编程语言：

brew install python@3.11
brew install node
brew install go
brew install rust
brew install openjdk@11  # Java 11

Cask 推荐：

brew install --cask iterm2
brew install --cask visual-studio-code
brew install --cask raycast
brew install --cask rectangle
brew install --cask alt-tab
brew install --cask obsidian
brew install --cask arc           # 浏览器
brew install --cask cursor        # AI 编辑器

15.9 性能优化：使用预编译 Bottle

默认会下载预编译包，但如果你之前设置了 HOMEBREW_BUILD_FROM_SOURCE=1，需要取消：

unset HOMEBREW_BUILD_FROM_SOURCE

15.10 优雅地删除 Homebrew

如果哪天不想用了：

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

会提示删除所有内容，谨慎操作。

附录：命令速查表

日常使用

服务管理

Tap & Cask

进阶

环境变量

🎓 学习路径建议

如果你是新手，建议按这个顺序学：

1. 第 1 天：安装 + install + list + uninstall
2. 第 1 周：掌握 update + upgrade + cleanup + doctor
3. 第 1 月：学 search + info + services + cask
4. 进阶：学 tap + bundle + 编写 Formula

📚 推荐资源

• 🏠 Homebrew 官网
• 📖 官方文档
• 🔍 Formulae 浏览
• 💻 GitHub 仓库
• 🌏 中文社区：搜索 "Homebrew 教程"

❓ 反馈

如果文档有错误或需要补充，欢迎指正！

版权说明：本文档基于 Homebrew 开源协议整理，仅供学习使用。
Homebrew 本身遵循 BSD 2-Clause License。