Homebrew 安裝教程 | macOS/Linux 包管理器快速上手指南

Homebrew 是 macOS 和 Linux 上最受歡迎的包管理器之一。它簡化了軟件安裝、更新和卸載的流程，讓開發者能夠專注於代碼而不是環境配置。本文將帶你從零開始，完成 Homebrew 的安裝和配置。

簡介

Homebrew 由開發者 Max Howell 開發，並基於 BSD 開源，是一個非常方便的包管理器工具。在早期， Homebrew 僅有 macOS 的版本，後續隨著用戶的增多，Homebrew 還提供了 Linux 的版本，幫助開發者在 Linux 同樣使用 Homebrew 來配置環境。

Homebrew 的核心特點

• 簡單易用：一條命令即可完成軟件安裝
• 自動化依賴管理：自動處理軟件依賴關係
• 開源免費：完全開源，社區活躍
• 跨平臺支持：同時支持 macOS 和 Linux
• 豐富的軟件庫：數萬個軟件包可供選擇

Homebrew vs 其他包管理器

特性	Homebrew	MacPorts	Fink
安裝方式	源碼編譯 + 預編譯	源碼編譯	源碼編譯
依賴管理	自動	自動	自動
系統整合	好	一般	一般
軟件數量	非常多	多	較少
更新頻率	快	中等	慢

安裝前的準備工作

系統要求

macOS:

• macOS 10.15 (Catalina) 或更高版本
• 命令行工具 (Command Line Tools)
• 網絡連接（建議配置鏡像源）

Linux:

• glibc 2.13 或更高版本
• 64 位 x86_64 架構
• GCC 4.4.7 或更高版本
• Git

安裝 Xcode Command Line Tools

在 macOS 上安裝 Homebrew 之前，需要先安裝命令行工具：

# 方法一：使用 xcode-select
xcode-select --install

# 方法二：從 Apple Developer 網站下載
# 訪問 https://developer.apple.com/download/

驗證安裝：

gcc --version
git --version

安裝 Homebrew

官方安裝方法（推薦）

/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

安裝過程說明：

1. 下載安裝腳本

   # 腳本會從 GitHub 下載最新的安裝程序
   curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install

2. 執行安裝

   # 安裝程序會：
   # - 創建 /usr/local/Homebrew 目錄
   # - 克隆 homebrew-core 倉庫
   # - 設置環境變量
   # - 配置權限

3. 驗證安裝

   brew --version
   # 輸出示例：Homebrew 4.x.x

國內鏡像安裝（加速）

如果你在中國大陸，建議使用鏡像源加速安裝：

使用清華大學鏡像

# 第一步：設置環境變量
export HOMEBREW_BREW_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git"
export HOMEBREW_CORE_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git"
export HOMEBREW_BOTTLE_DOMAIN="https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles"

# 第二步：執行安裝
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 第三步：配置持久化
echo 'export HOMEBREW_BREW_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git"' >> ~/.zshrc
echo 'export HOMEBREW_CORE_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git"' >> ~/.zshrc
echo 'export HOMEBREW_BOTTLE_DOMAIN="https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles"' >> ~/.zshrc
source ~/.zshrc

使用中科大鏡像

# 設置環境變量
export HOMEBREW_BREW_GIT_REMOTE="git://mirrors.ustc.edu.cn/brew.git"
export HOMEBREW_CORE_GIT_REMOTE="git://mirrors.ustc.edu.cn/homebrew-core.git"
export HOMEBREW_BOTTLE_DOMAIN="https://mirrors.ustc.edu.cn/homebrew-bottles"

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

Linux 安裝

在 Linux 上安裝 Homebrew（也稱為 Linuxbrew）：

# 安裝依賴
sudo apt-get install build-essential procps curl file git  # Debian/Ubuntu
sudo yum groupinstall 'Development Tools'                   # CentOS/RHEL

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

# 配置環境變量
echo 'eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"' >> ~/.profile
eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"

檢查 Hombrew 環境

如果你的 Hombrew 沒有辦法正常的工作，你可以執行 brew doctor 來開啟 Homebrew 自帶的檢查，從而確認有哪些問題，並進行修復。

常見問題及解決方案

# 運行診斷
brew doctor

# 常見警告及解決方法：

# 1. 過時的 Command Line Tools
# 解決：更新 Xcode Command Line Tools
sudo rm -rf /Library/Developer/CommandLineTools
xcode-select --install

# 2. 未設置的 PATH
# 解決：添加 Homebrew 到 PATH
echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

# 3. 權限問題
# 解決：修復權限
sudo chown -R $(whoami) /usr/local/*
sudo chmod -R u+w /usr/local/*

# 4. 未鏈接的 keg-only 軟件
# 解決：按需鏈接
brew link --force software_name

查看詳細配置信息

# 查看 Homebrew 配置
brew config

# 輸出包含：
# - macOS 版本
# - Homebrew 版本
# - Ruby 版本
# - Git 版本
# - 系統架構等信息

更新 Homebrew

brew update

更新策略

# 1. 更新 Homebrew 本身
brew update

# 2. 查看所有可更新的軟件
brew outdated

# 3. 更新所有軟件
brew upgrade

# 4. 更新特定軟件
brew upgrade nginx

# 5. 清理舊版本
brew cleanup

# 6. 一鍵更新並清理（推薦）
brew update && brew upgrade && brew cleanup

自動更新配置

# 禁用自動更新（加快 brew 命令速度）
export HOMEBREW_NO_AUTO_UPDATE=1

# 添加到 shell 配置文件
echo 'export HOMEBREW_NO_AUTO_UPDATE=1' >> ~/.zshrc

使用 Brewfile 完成環境遷移

設備用久了，我們的電腦中會有大量的軟件，如果你需要遷移環境，重新安裝會是一個大麻煩，好在 Homebrew 本身為我們提供了一個非常好用的環境遷移的工具 —— Homebrew Bundle

安裝 Homebrew Bundle

# Homebrew Bundle 通常已內置
# 如果沒有，可以手動安裝
brew tap Homebrew/bundle

導出當前環境

你首先需要在之前的電腦中執行 brew bundle dump 來完成當前環境的導出,導出完成後，你會得到一個 Brewfile。

# 導出所有已安裝的軟件
brew bundle dump

# 導出到指定文件
brew bundle dump --file=~/Backup/Brewfile

# 包含 cask 軟件（圖形界面應用）
brew bundle dump --describe --force

Brewfile 示例：

# Brewfile

# Taps
tap "homebrew/bundle"
tap "homebrew/cask"
tap "homebrew/cask-fonts"
tap "homebrew/core"

# Formulae (命令行工具)
brew "git"
brew "node"
brew "nginx"
brew "mysql"
brew "redis"
brew "wget"
brew "tree"
brew "htop"

# Casks (圖形界面應用)
cask "visual-studio-code"
cask "google-chrome"
cask "iterm2"
cask "docker"
cask "notion"

# Fonts
cask "font-fira-code"
cask "font-jetbrains-mono"
cask "font-source-code-pro"

恢復環境

然後將 Brewfile 複製到新的電腦中，並執行 brew bundle 來開始安裝的過程。

# 從當前目錄的 Brewfile 安裝
brew bundle

# 從指定文件安裝
brew bundle --file=~/Backup/Brewfile

# 跳過已安裝的軟件（加快速度）
brew bundle --no-upgrade

# 僅安裝，不更新已有軟件
brew bundle install

Brewfile 最佳實踐

1. 分類管理軟件

# Brewfile.dev

# 核心工具
brew "git"
brew "node"
brew "python"

# 數據庫
brew "mysql"
brew "postgresql"
brew "redis"
brew "mongodb-community"

# Web 服務器
brew "nginx"
brew "apache2"

# 開發工具
brew "vim"
brew "neovim"
brew "tmux"
brew "zsh"

# 監控工具
brew "htop"
brew "iftop"
brew "nmap"

2. 團隊協作

# 將 Brewfile 提交到版本控制
git add Brewfile
git commit -m "chore: add Brewfile for development environment"

# 團隊成員同步環境
git pull
brew bundle

3. CI/CD 集成

# .github/workflows/setup.yml
name: Setup Environment
on: [push]
jobs:
  setup:
    runs-on: macos-latest
    steps:
      - uses: actions/checkout@v2
      - name: Install Homebrew packages
        run: brew bundle --file=Brewfile

Homebrew 目錄結構

瞭解 Homebrew 的目錄結構有助於更好地管理和排查問題：

# 查看 Homebrew 安裝位置
brew --prefix
# 輸出：/usr/local (Intel Mac) 或 /opt/homebrew (Apple Silicon)

# 主要目錄說明
/usr/local/
├── Cellar/          # 軟件包的實際安裝位置
├── opt/             # 指向 Cellar 中最新版本的符號鏈接
├── bin/             # 可執行文件
├── include/         # 頭文件
├── lib/             # 庫文件
├── share/           # 共享資源
└── etc/             # 配置文件

常見問題排查

問題 1：安裝速度慢或失敗

# 解決方案：使用鏡像源
export HOMEBREW_BREW_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git"
export HOMEBREW_CORE_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git"
export HOMEBREW_BOTTLE_DOMAIN="https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles"

問題 2：權限錯誤

# 修復權限
sudo chown -R $(whoami):admin /usr/local/*
sudo chmod -R g+w /usr/local/*

# 或者重置整個 Homebrew
sudo rm -rf /usr/local/Homebrew
# 重新安裝

問題 3：找不到 brew 命令

# 檢查 PATH
echo $PATH

# 添加 Homebrew 到 PATH
echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

# Apple Silicon Mac
echo 'export PATH="/opt/homebrew/bin:$PATH"' >> ~/.zshrc

問題 4：依賴衝突

# 查看依賴樹
brew deps --tree nginx

# 強制重新安裝
brew reinstall nginx

# 清理並重新鏈接
brew unlink nginx && brew link nginx

卸載 Homebrew

如果需要完全卸載 Homebrew：

# 下載卸載腳本
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/uninstall.sh)"

# 或使用本地腳本
brew uninstall --force $(brew list)
rm -rf /usr/local/Homebrew
rm -rf ~/.cache/Homebrew

下一步學習

恭喜你完成了 Homebrew 的安裝！接下來可以學習：

• Homebrew 軟件管理 - 掌握常用軟件操作
• Homebrew Tap 擴展 - 擴展軟件源
• Homebrew 鏡像源 - 加速下載

總結

本文詳細介紹了 Homebrew 的安裝和配置：

1. 安裝準備：Xcode Command Line Tools
2. 安裝方法：官方安裝和鏡像加速
3. 環境檢查：brew doctor 診斷
4. 更新策略：保持軟件最新
5. 環境遷移：Brewfile 的使用
6. 問題排查：常見問題解決方案

關鍵要點：

• ✅ 中國大陸用戶建議使用鏡像源
• ✅ 定期運行 brew doctor 檢查環境
• ✅ 使用 Brewfile 管理開發環境
• ✅ 保持 Homebrew 和軟件包更新

現在你已經準備好使用 Homebrew 來管理你的開發環境了！🎉