Homebrew 包管理与自动化配置 2026

🍺 macOS 缺少的包管理器。 Homebrew 是 Mac 开发者的必备工具,它让安装、更新、管理软件变得无比简单。从命令行工具到图形界面应用,从编程语言到数据库,一键搞定。本文带你从入门到精通,打造高效的 Homebrew 工作流。
本文将带你系统掌握:
- ✅ Homebrew 安装与配置
- ✅ 常用命令速查
- ✅ Cask 应用管理
- ✅ Taps 第三方源
- ✅ Brewfile 批量管理
- ✅ 自动化配置脚本
- ✅ 性能优化与清理
- ✅ 常见问题处理
一、Homebrew 简介
1.1 什么是 Homebrew
Homebrew 是 macOS(及 Linux)的包管理器:
- 安装软件:一条命令搞定
- 更新软件:一键全部更新
- 卸载软件:干净彻底
- 管理依赖:自动处理
1.2 核心概念
| 概念 | 说明 |
|---|---|
| formula | 命令行软件包(如 git、node) |
| cask | GUI 应用程序(如 Chrome、VS Code) |
| tap | 第三方软件源 |
| keg | 某个 formula 的安装目录 |
| Cellar | 所有 keg 的存放位置 |
| Brewfile | 软件清单文件,可批量安装 |
二、安装与配置
2.1 安装 Homebrew
# 官方安装命令
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# 验证安装
brew --version2.2 配置环境变量
Intel Mac:
# Homebrew 安装在 /usr/local
echo 'eval "$(/usr/local/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/usr/local/bin/brew shellenv)"Apple Silicon (M1/M2/M3/M4):
# Homebrew 安装在 /opt/homebrew
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"2.3 换源加速
国内用户建议使用中科大或清华镜像:
中科大镜像:
# formula 源
git -C "$(brew --repo)" remote set-url origin https://mirrors.ustc.edu.cn/brew.git
# homebrew-core
git -C "$(brew --repo homebrew/core)" remote set-url origin https://mirrors.ustc.edu.cn/homebrew-core.git
# homebrew-cask
git -C "$(brew --repo homebrew/cask)" remote set-url origin https://mirrors.ustc.edu.cn/homebrew-cask.git
# 预编译二进制包
echo 'export HOMEBREW_BOTTLE_DOMAIN=https://mirrors.ustc.edu.cn/homebrew-bottles/bottles' >> ~/.zprofile清华镜像:
git -C "$(brew --repo)" remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git
git -C "$(brew --repo homebrew/core)" remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git
echo 'export HOMEBREW_BOTTLE_DOMAIN=https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles' >> ~/.zprofile2.4 常用环境变量
# ~/.zprofile
# 禁止收集使用数据
export HOMEBREW_NO_ANALYTICS=1
# 自动更新(默认开启)
export HOMEBREW_NO_AUTO_UPDATE=1 # 禁用自动更新
# 并行下载数
export HOMEBREW_JOBS=8
# 不显示 emoji(旧终端)
export HOMEBREW_NO_EMOJI=1
# 安装完成后不清理旧版本
export HOMEBREW_NO_INSTALL_CLEANUP=1三、常用命令
3.1 软件安装与卸载
# 安装 formula
brew install git
brew install node python
# 安装特定版本
brew install node@20
# 安装 cask(GUI 应用)
brew install --cask google-chrome
brew install --cask visual-studio-code
# 卸载
brew uninstall git
brew uninstall --cask google-chrome
# 彻底卸载(包括配置文件)
brew uninstall --zap --cask app-cleaner3.2 更新与升级
# 更新 Homebrew 本身和公式列表
brew update
# 查看可更新的软件
brew outdated
# 升级所有软件
brew upgrade
# 升级指定软件
brew upgrade git
# 升级 cask
brew upgrade --cask3.3 搜索与信息
# 搜索软件
brew search node
brew search --cask chrome
# 查看软件信息
brew info git
brew info --cask google-chrome
# 查看已安装的软件
brew list
brew list --cask
# 查看软件依赖
brew deps git3.4 服务管理
# 查看运行中的服务
brew services list
# 启动服务
brew services start mysql
brew services start postgresql
# 停止服务
brew services stop mysql
# 重启服务
brew services restart mysql
# 开机自启
brew services start mysql # 自动注册为开机启动3.5 清理与维护
# 清理旧版本
brew cleanup
brew cleanup git # 清理指定软件
# 查看哪些可以清理
brew cleanup --dry-run
# 清理缓存
brew cleanup -s
# 诊断问题
brew doctor
# 修复权限
brew repair
# 编辑 formula
brew edit git四、Cask 应用管理
4.1 常用 Cask 应用推荐
浏览器:
brew install --cask google-chrome
brew install --cask firefox
brew install --cask arc
brew install --cask microsoft-edge开发工具:
brew install --cask visual-studio-code
brew install --cask iterm2
brew install --cask docker
brew install --cask postman
brew install --cask tableplus
brew install --cask cyberduck效率工具:
brew install --cask alfred
brew install --cask raycast
brew install --cask notion
brew install --cask obsidian
brew install --cask rectangle
brew install --cask karabiner-elements媒体:
brew install --cask vlc
brew install --cask iina
brew install --cask spotify通讯:
brew install --cask wechat
brew install --cask telegram
brew install --cask discord
brew install --cask slack4.2 Cask 高级用法
# 查看已安装的 cask
brew list --cask
# 查看 cask 信息
brew info --cask google-chrome
# 重新安装
brew reinstall --cask visual-studio-code
# 强制卸载
brew uninstall --force --cask app-name五、Taps 第三方源
5.1 常用 Taps
# 查看已添加的 tap
brew tap
# 添加 tap
brew tap homebrew/cask-fonts # 字体
brew tap homebrew/cask-versions # 旧版本应用
brew tap homebrew/services # 服务管理5.2 字体安装
# 添加字体源
brew tap homebrew/cask-fonts
# 搜索字体
brew search --cask font-fira
# 安装字体
brew install --cask font-fira-code
brew install --cask font-hack-nerd-font
brew install --cask font-jetbrains-mono
brew install --cask font-cascadia-code5.3 版本管理
# 安装特定版本的应用
brew tap homebrew/cask-versions
# 旧版本 Firefox
brew install --cask firefox-esr
# 旧版 Chrome
brew install --cask google-chrome-beta
brew install --cask google-chrome-canary六、Brewfile 批量管理
6.1 什么是 Brewfile
Brewfile 是一个软件清单文件,格式如下:
# Brewfile
# taps
tap "homebrew/cask-fonts"
tap "homebrew/cask-versions"
# formulae
brew "git"
brew "node"
brew "python"
brew "pnpm"
brew "fzf"
brew "tmux"
brew "zsh"
# casks
cask "visual-studio-code"
cask "iterm2"
cask "google-chrome"
cask "alfred"
# 字体
cask "font-fira-code"6.2 生成 Brewfile
将当前已安装的软件导出为 Brewfile:
# 在当前目录生成 Brewfile
brew bundle dump
# 生成到指定位置
brew bundle dump --file=~/Brewfile
# 强制覆盖
brew bundle dump --force6.3 从 Brewfile 安装
# 安装当前目录的 Brewfile 中的所有软件
brew bundle
# 指定 Brewfile 路径
brew bundle --file=~/Brewfile
# 仅检查,不实际安装
brew bundle check
# 列出要安装的
brew bundle list6.4 完整 Brewfile 示例
# Brewfile - 开发者必备工具
# ===== Taps =====
tap "homebrew/cask-fonts"
tap "homebrew/cask-versions"
# ===== 命令行工具 =====
# 基础
brew "git"
brew "zsh"
brew "zsh-autosuggestions"
brew "zsh-syntax-highlighting"
brew "fzf"
brew "fd"
brew "ripgrep"
brew "bat"
brew "htop"
brew "tmux"
brew "tree"
brew "wget"
brew "curl"
brew "jq"
brew "htop"
brew "nano"
# 开发语言
brew "node"
brew "pnpm"
brew "python"
brew "go"
brew "rust"
# 数据库
brew "mysql"
brew "postgresql"
brew "redis"
brew "mongodb-community"
# 云服务
brew "awscli"
brew "kubectl"
brew "docker"
# 网络
brew "openssl"
brew "dnsmasq"
# ===== GUI 应用 =====
cask "visual-studio-code"
cask "iterm2"
cask "google-chrome"
cask "firefox"
cask "docker"
cask "postman"
cask "tableplus"
cask "alfred"
cask "obsidian"
cask "notion"
cask "rectangle"
cask "vlc"
cask "spotify"
cask "telegram"
cask "wechat"
# ===== 字体 =====
cask "font-fira-code"
cask "font-jetbrains-mono"
cask "font-hack-nerd-font"七、自动化配置脚本
7.1 一键安装脚本
#!/bin/bash
# setup-mac.sh - Mac 开发环境一键配置
set -e
echo "🚀 开始配置 Mac 开发环境..."
# 1. 安装 Homebrew
if ! command -v brew &> /dev/null; then
echo "📦 安装 Homebrew..."
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# 配置环境变量
if [[ $(uname -m) == 'arm64' ]]; then
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"
else
echo 'eval "$(/usr/local/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/usr/local/bin/brew shellenv)"
fi
fi
# 2. 配置国内源
echo "🌐 配置国内镜像源..."
git -C "$(brew --repo)" remote set-url origin https://mirrors.ustc.edu.cn/brew.git
git -C "$(brew --repo homebrew/core)" remote set-url origin https://mirrors.ustc.edu.cn/homebrew-core.git
git -C "$(brew --repo homebrew/cask)" remote set-url origin https://mirrors.ustc.edu.cn/homebrew-cask.git
# 3. 安装软件
echo "🍺 安装软件..."
# 添加 taps
brew tap homebrew/cask-fonts
brew tap homebrew/cask-versions
# 基础工具
brew install git zsh fzf fd ripgrep bat tmux htop tree wget jq
# 开发工具
brew install node pnpm python go
brew install mysql redis postgresql
# GUI 应用
brew install --cask visual-studio-code iterm2
brew install --cask google-chrome firefox
brew install --cask docker postman
brew install --cask alfred obsidian
brew install --cask vlc spotify
# 字体
brew install --cask font-fira-code font-jetbrains-mono
# 4. 配置 zsh
echo "💻 配置 zsh..."
if [ ! -d "$HOME/.oh-my-zsh" ]; then
sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"
fi
# 5. 生成 Brewfile
echo "📝 生成 Brewfile..."
brew bundle dump --force --file=~/Brewfile
echo "✅ 配置完成!请重新打开终端。"7.2 使用方式
# 保存为 setup-mac.sh
chmod +x setup-mac.sh
./setup-mac.sh八、性能优化与清理
8.1 加速 Homebrew
使用国内镜像:
参考 2.3 节换源。
禁用自动更新:
export HOMEBREW_NO_AUTO_UPDATE=1
# 需要更新时手动执行
brew update && brew upgrade并行下载:
export HOMEBREW_JOBS=88.2 清理空间
# 查看占用空间
du -sh $(brew --prefix)
# 清理所有旧版本
brew cleanup
# 清理缓存下载
brew cleanup -s
# 清理 7 天前的缓存
brew cleanup --prune=78.3 常见问题修复
# 诊断问题
brew doctor
# 修复权限问题
sudo chown -R $(whoami) $(brew --prefix)/*
# 重置 formula
brew reinstall git
# 强制卸载
brew uninstall --force git
# 卸载并删除所有版本
brew uninstall --force git && brew cleanup git九、开发语言管理
9.1 Node.js 版本管理
# 安装 nvm
brew install nvm
# 配置
export NVM_DIR="$HOME/.nvm"
source $(brew --prefix nvm)/nvm.sh
# 使用
nvm install 20
nvm use 20
nvm alias default 209.2 Python 版本管理
# 安装 pyenv
brew install pyenv
# 配置
export PYENV_ROOT="$HOME/.pyenv"
export PATH="$PYENV_ROOT/bin:$PATH"
eval "$(pyenv init -)"
# 使用
pyenv install 3.12
pyenv global 3.129.3 Java 版本管理
# 安装 jenv
brew install jenv
# 安装 Java
brew install openjdk@17
brew install openjdk@21
# 添加到 jenv
jenv add /opt/homebrew/opt/openjdk@17
jenv add /opt/homebrew/opt/openjdk@21
# 切换版本
jenv global 17十、常用命令速查
# ===== 基础 =====
brew install <formula> # 安装
brew uninstall <formula> # 卸载
brew upgrade # 全部更新
brew update # 更新公式列表
brew search <keyword> # 搜索
brew info <formula> # 查看信息
brew list # 已安装列表
brew doctor # 诊断问题
brew cleanup # 清理
# ===== Cask =====
brew install --cask <app> # 安装 GUI 应用
brew uninstall --cask <app> # 卸载 GUI 应用
brew list --cask # 已安装 GUI 应用
brew upgrade --cask # 更新 GUI 应用
# ===== 服务 =====
brew services list # 服务列表
brew services start <name> # 启动服务
brew services stop <name> # 停止服务
brew services restart <name> # 重启服务
# ===== Bundle =====
brew bundle # 从 Brewfile 安装
brew bundle dump # 导出 Brewfile
brew bundle check # 检查是否都已安装
# ===== Taps =====
brew tap # 列出 tap
brew tap <repo> # 添加 tap
brew untap <repo> # 移除 tap十一、总结
Homebrew 是 Mac 开发者的瑞士军刀:
- 安装简单:一条命令搞定
- 管理方便:统一安装、更新、卸载
- Cask 强大:GUI 应用也能命令行管理
- Brewfile:批量安装,快速配置新机器
- 自动化:配合脚本实现零配置环境搭建
🍺 善用 Homebrew,让你的 Mac 配置变得可复制、可版本化、自动化。
相关文章推荐: