Homebrew 入门教程（2025 年最新版）
一、Homebrew 简介
Homebrew 是 macOS 和 Linux 系统上最流行的包管理工具，简称「brew」。它能够简化软件安装流程，支持自动处理依赖关系，并提供便捷的更新、卸载功能。本文将带你从安装到实战，全面掌握 Homebrew 的使用技巧。
二、安装 Homebrew
1. 一键安装命令
打开终端（Terminal），复制粘贴以下命令并回车：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
- 说明：该命令会自动安装 Homebrew 到
/usr/local目录，并配置环境变量。 - 提示：安装完成后，根据终端提示将 Homebrew 路径添加到
~/.zshrc或~/.bash_profile中。
2. 验证安装
输入以下命令，若显示版本号则安装成功：
brew -v
三、配置国内镜像源（加速下载）
1. 为什么需要镜像源？
Homebrew 默认从 GitHub 下载软件包，国内用户可能遇到速度慢或连接失败的问题。建议切换至国内镜像源（如清华大学、中科大、阿里云）。
2. 配置步骤（以清华大学镜像为例）
# 配置 Homebrew 核心仓库
git -C "$(brew --repo)" remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git# 配置 Homebrew 公式仓库
git -C "$(brew --repo homebrew/core)" remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git# 配置 Bottles 预编译包
export HOMEBREW_BOTTLE_DOMAIN=https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles
3. 更新 Homebrew
brew update
四、基础命令详解
1. 软件包管理
| 命令 | 用途 | 示例 |
|---|---|---|
brew search <关键词> | 搜索软件包 | brew search python |
brew install <包名> | 安装软件包 | brew install git |
brew uninstall <包名> | 卸载软件包 | brew uninstall python |
brew list | 列出已安装的包 | - |
brew info <包名> | 查看包详情（版本、依赖等） | brew info node |
brew upgrade | 升级所有已安装的包 | - |
brew upgrade <包名> | 升级指定包 | brew upgrade mysql |
brew cleanup | 清理旧版本和缓存 | - |
2. Cask 扩展（安装 macOS 应用）
# 安装 Cask 扩展
brew tap homebrew/cask# 安装应用（如 Chrome）
brew install --cask google-chrome# 卸载应用
brew uninstall --cask google-chrome
3. 服务管理（后台服务）
# 启动服务（如 MySQL）
brew services start mysql# 停止服务
brew services stop mysql# 重启服务
brew services restart mysql# 查看服务状态
brew services list
五、高级操作
1. 安装指定版本软件
# 添加版本库
brew tap homebrew/cask-versions# 安装 Python 3.8
brew install python@3.8
2. 查看依赖关系
# 以树形图显示依赖
brew deps --installed --tree
3. 锁定包版本（防止自动升级）
brew pin <包名> # 锁定
brew unpin <包名> # 解锁
六、常见问题解决
1. 权限问题
现象：Permission denied 错误。
解决方案：
# 修复权限
sudo chown -R $(whoami) $(brew --prefix)/*
2. 下载速度慢
解决方案：切换至国内镜像源（见本文第三部分）。
3. 卸载 Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/uninstall.sh)"
七、总结
通过本文，你已掌握 Homebrew 的以下技能：
- 快速安装与配置国内镜像源。
- 软件包的搜索、安装、升级、卸载。
- 管理后台服务与依赖关系。
- 解决常见权限与速度问题。
Homebrew 的核心优势在于自动化处理依赖和简化流程，建议定期执行 brew update && brew upgrade && brew cleanup 保持系统整洁。