跳转到内容

Homebrew 包管理与自动化配置 2026

Homebrew 包管理

🍺 macOS 缺少的包管理器。 Homebrew 是 Mac 开发者的必备工具,它让安装、更新、管理软件变得无比简单。从命令行工具到图形界面应用,从编程语言到数据库,一键搞定。本文带你从入门到精通,打造高效的 Homebrew 工作流。

本文将带你系统掌握:

  • ✅ Homebrew 安装与配置
  • ✅ 常用命令速查
  • ✅ Cask 应用管理
  • ✅ Taps 第三方源
  • ✅ Brewfile 批量管理
  • ✅ 自动化配置脚本
  • ✅ 性能优化与清理
  • ✅ 常见问题处理

一、Homebrew 简介

1.1 什么是 Homebrew

Homebrew 是 macOS(及 Linux)的包管理器:

  • 安装软件:一条命令搞定
  • 更新软件:一键全部更新
  • 卸载软件:干净彻底
  • 管理依赖:自动处理

1.2 核心概念

概念说明
formula命令行软件包(如 git、node)
caskGUI 应用程序(如 Chrome、VS Code)
tap第三方软件源
keg某个 formula 的安装目录
Cellar所有 keg 的存放位置
Brewfile软件清单文件,可批量安装

二、安装与配置

2.1 安装 Homebrew

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

# 验证安装
brew --version

2.2 配置环境变量

Intel Mac:

bash
# Homebrew 安装在 /usr/local
echo 'eval "$(/usr/local/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/usr/local/bin/brew shellenv)"

Apple Silicon (M1/M2/M3/M4):

bash
# Homebrew 安装在 /opt/homebrew
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

2.3 换源加速

国内用户建议使用中科大或清华镜像:

中科大镜像:

bash
# 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

清华镜像:

bash
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' >> ~/.zprofile

2.4 常用环境变量

bash
# ~/.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 软件安装与卸载

bash
# 安装 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-cleaner

3.2 更新与升级

bash
# 更新 Homebrew 本身和公式列表
brew update

# 查看可更新的软件
brew outdated

# 升级所有软件
brew upgrade

# 升级指定软件
brew upgrade git

# 升级 cask
brew upgrade --cask

3.3 搜索与信息

bash
# 搜索软件
brew search node
brew search --cask chrome

# 查看软件信息
brew info git
brew info --cask google-chrome

# 查看已安装的软件
brew list
brew list --cask

# 查看软件依赖
brew deps git

3.4 服务管理

bash
# 查看运行中的服务
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 清理与维护

bash
# 清理旧版本
brew cleanup
brew cleanup git           # 清理指定软件

# 查看哪些可以清理
brew cleanup --dry-run

# 清理缓存
brew cleanup -s

# 诊断问题
brew doctor

# 修复权限
brew repair

# 编辑 formula
brew edit git

四、Cask 应用管理

4.1 常用 Cask 应用推荐

浏览器:

bash
brew install --cask google-chrome
brew install --cask firefox
brew install --cask arc
brew install --cask microsoft-edge

开发工具:

bash
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

效率工具:

bash
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

媒体:

bash
brew install --cask vlc
brew install --cask iina
brew install --cask spotify

通讯:

bash
brew install --cask wechat
brew install --cask telegram
brew install --cask discord
brew install --cask slack

4.2 Cask 高级用法

bash
# 查看已安装的 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

bash
# 查看已添加的 tap
brew tap

# 添加 tap
brew tap homebrew/cask-fonts      # 字体
brew tap homebrew/cask-versions   # 旧版本应用
brew tap homebrew/services       # 服务管理

5.2 字体安装

bash
# 添加字体源
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-code

5.3 版本管理

bash
# 安装特定版本的应用
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 是一个软件清单文件,格式如下:

ruby
# 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:

bash
# 在当前目录生成 Brewfile
brew bundle dump

# 生成到指定位置
brew bundle dump --file=~/Brewfile

# 强制覆盖
brew bundle dump --force

6.3 从 Brewfile 安装

bash
# 安装当前目录的 Brewfile 中的所有软件
brew bundle

# 指定 Brewfile 路径
brew bundle --file=~/Brewfile

# 仅检查,不实际安装
brew bundle check

# 列出要安装的
brew bundle list

6.4 完整 Brewfile 示例

ruby
# 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 一键安装脚本

bash
#!/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 使用方式

bash
# 保存为 setup-mac.sh
chmod +x setup-mac.sh
./setup-mac.sh

八、性能优化与清理

8.1 加速 Homebrew

使用国内镜像:

参考 2.3 节换源。

禁用自动更新:

bash
export HOMEBREW_NO_AUTO_UPDATE=1

# 需要更新时手动执行
brew update && brew upgrade

并行下载:

bash
export HOMEBREW_JOBS=8

8.2 清理空间

bash
# 查看占用空间
du -sh $(brew --prefix)

# 清理所有旧版本
brew cleanup

# 清理缓存下载
brew cleanup -s

# 清理 7 天前的缓存
brew cleanup --prune=7

8.3 常见问题修复

bash
# 诊断问题
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 版本管理

bash
# 安装 nvm
brew install nvm

# 配置
export NVM_DIR="$HOME/.nvm"
source $(brew --prefix nvm)/nvm.sh

# 使用
nvm install 20
nvm use 20
nvm alias default 20

9.2 Python 版本管理

bash
# 安装 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.12

9.3 Java 版本管理

bash
# 安装 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

十、常用命令速查

bash
# ===== 基础 =====
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 开发者的瑞士军刀:

  1. 安装简单:一条命令搞定
  2. 管理方便:统一安装、更新、卸载
  3. Cask 强大:GUI 应用也能命令行管理
  4. Brewfile:批量安装,快速配置新机器
  5. 自动化:配合脚本实现零配置环境搭建

🍺 善用 Homebrew,让你的 Mac 配置变得可复制、可版本化、自动化。


相关文章推荐: