brew完全指南：从零开始掌握macOS包管理神器

你还在为macOS上软件安装繁琐而烦恼？手动管理依赖关系让你头大？本文将带你全面掌握Homebrew（简称brew）——这款被誉为"macOS缺失的包管理器"，从安装到高级技巧，让你轻松搞定软件管理。

读完本文你将学会：

• 在不同Mac机型上正确安装brew
• 使用brew安装、更新和卸载各类软件
• 掌握实用的brew命令和效率技巧
• 解决常见的brew使用问题

为什么选择Homebrew？

Homebrew是一款专为macOS（也支持Linux）设计的包管理工具，它能让你通过简单的命令行操作安装、管理和更新各种开源软件。相比手动下载安装，Homebrew提供了以下优势：

• 自动化处理软件依赖关系
• 一键更新所有已安装软件
• 轻松切换软件版本
• 彻底卸载软件，不留痕迹
• 访问大量精选的开源软件包

官方文档：docs/README.md

安装Homebrew

系统要求

在安装前，请确保你的Mac满足以下条件：

• Apple Silicon或64位Intel CPU
• macOS Sonoma (14)或更高版本
• 已安装Xcode命令行工具(CLT)或Xcode

标准安装步骤

打开终端，执行以下命令：

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

脚本会自动将Homebrew安装到默认位置：

• Apple Silicon: /opt/homebrew
• Intel: /usr/local

安装过程中，脚本会清晰地告知将要执行的操作，需要你确认后才会继续。

国内网络优化

如果访问GitHub有困难，可以使用Git镜像：

export HOMEBREW_BREW_GIT_REMOTE="https://gitcode.com/GitHub_Trending/br/brew"
export HOMEBREW_CORE_GIT_REMOTE="https://gitcode.com/GitHub_Trending/br/homebrew-core"
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

安装验证

安装完成后，运行以下命令验证：

brew --version

如果输出类似以下内容，说明安装成功：

Homebrew 4.3.0
Homebrew/homebrew-core (git revision abc123; last commit 2025-09-30)

官方安装文档：docs/Installation.md

基本使用指南

安装软件

使用brew install命令安装软件：

# 安装命令行工具
brew install wget

# 安装图形界面应用
brew install --cask google-chrome

注意：命令行工具使用brew install <包名>，图形界面应用使用brew install --cask <应用名>

搜索软件

不确定软件的确切名称？使用brew search搜索：

# 搜索与"python"相关的包
brew search python

# 搜索可用的cask应用
brew search --cask text

查看软件信息

使用brew info查看软件详情：

brew info node

输出将包含软件描述、版本、依赖关系、安装选项等信息。

更新软件

# 更新Homebrew自身
brew update

# 更新所有已安装软件
brew upgrade

# 更新特定软件
brew upgrade node

卸载软件

# 卸载命令行工具
brew uninstall wget

# 卸载图形界面应用
brew uninstall --cask google-chrome

# 卸载并清除配置文件
brew uninstall --zap --cask google-chrome

列出已安装软件

# 列出所有已安装的命令行工具
brew list

# 列出所有已安装的cask应用
brew list --cask

高级使用技巧

安装特定版本的软件

某些情况下，你可能需要安装特定版本的软件：

# 安装Python 3.9版本
brew install python@3.9

如果需要更旧的版本，可以使用brew extract命令从历史版本中提取：

brew extract --version=2.7.18 python homebrew/cask-versions

版本管理文档：docs/Versions.md

管理软件依赖

# 仅安装软件的依赖，不安装软件本身
brew install --only-dependencies node

# 检查依赖关系问题
brew doctor

创建软件别名

使用brew alias创建自定义命令别名：

# 创建别名
brew alias i='install'
brew alias ug='upgrade'

# 使用别名
brew i wget
brew ug

清理系统

Homebrew会保留下载的安装包和旧版本软件，可以定期清理：

# 清理过时的下载缓存
brew cleanup -s

# 清理特定软件的旧版本
brew cleanup node

# 查看可清理的内容，不实际执行
brew cleanup -n

使用Brewfile管理软件集

Brewfile可以记录你的软件安装列表，方便在新系统上快速恢复：

# 导出当前安装列表到Brewfile
brew bundle dump

# 在新系统上从Brewfile安装
brew bundle install

Brewfile文档：docs/Brew-Bundle-and-Brewfile.md

故障排除

常见问题解决

如果遇到Homebrew相关问题，首先尝试：

# 检查系统配置问题
brew doctor

# 更新Homebrew
brew update-reset

解决网络问题

如果安装软件时遇到下载问题，可以尝试预下载安装包：

# 预下载软件安装包
brew fetch --force node

# 查看缓存位置
brew --cache node

然后将下载好的文件手动移动到缓存目录。

官方故障排除文档

更多问题解决方法，请参考：docs/Troubleshooting.md

扩展Homebrew功能

使用第三方仓库(Taps)

Homebrew默认只包含官方精选的软件包，你可以添加第三方仓库获取更多软件：

# 添加第三方仓库
brew tap homebrew/versions
brew tap homebrew/science

# 查看已添加的仓库
brew tap

# 移除仓库
brew untap homebrew/science

Taps文档：docs/Taps.md

安装命令补全

为了获得更好的命令行体验，可以安装bash或zsh的命令补全：

# 安装bash补全
brew install bash-completion@2

# 安装zsh补全
brew install zsh-completions

补全功能文档：docs/Shell-Completion.md

总结

Homebrew作为macOS上最受欢迎的包管理工具，极大地简化了软件的安装和管理流程。从基本的install、update命令到高级的版本管理和依赖处理，Homebrew提供了一套完整的解决方案。

通过本文介绍的技巧，你应该能够高效地使用Homebrew管理系统中的软件。记住，Homebrew的生态系统非常活跃，定期运行brew update可以确保你获得最新的功能和安全更新。

官方维护指南：docs/Maintainer-Guidelines.md

希望这篇指南能帮助你更好地利用Homebrew提升工作效率！