從零開始的 Mac 開發環境：Brewfile 完全指南

本篇是「一鍵搞定新 Mac」系列的第 3 / 9 篇。你可以從系列總覽開始閱讀，也可以直接接著看本文。

如果你剛拿到一台新 Mac，或者想把開發環境「版本控制」起來，Brewfile 是你該認識的第一個工具。

Homebrew 是什麼？

Homebrew 是 macOS 上最主流的套件管理工具，讓你用一行指令安裝 CLI 工具、桌面應用程式、甚至 VS Code extensions。

安裝 Homebrew：

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

裝完之後，安裝軟體就是一行指令的事：

brew install git        # CLI 工具
brew install --cask firefox  # 桌面 App

Brewfile 是什麼？

Brewfile 就是一份「軟體清單」，把你所有用 Homebrew 安裝的東西記錄在一個檔案裡。換電腦時，一行指令就能全部裝回來。

你可以把它想成「開發環境的 package.json」。

3 分鐘快速上手

Step 1：產生你的第一份 Brewfile

brew bundle dump --file=~/Brewfile

這會掃描你目前已安裝的所有 Homebrew 套件，自動產生一份 Brewfile。

Step 2：看看裡面有什麼

cat ~/Brewfile

你會看到四種類型的項目：

tap "homebrew/cask"          # 第三方套件來源
brew "git"                   # CLI 工具
cask "firefox"               # 桌面 App
vscode "dbaeumer.vscode-eslint"  # VS Code 擴充（可選）

Step 3：在新電腦上還原

把 Brewfile 複製到新電腦，然後：

brew bundle install --file=~/Brewfile

就這樣，所有工具一次裝完。

我推薦每個開發者都該有的基礎工具

以下是我自己 Brewfile 裡最常用的工具，依用途分類：

Git 相關

brew "git"          # 版本控制
brew "gh"           # GitHub CLI，PR、issue 都在終端搞定
brew "lazygit"      # Git 的 TUI 介面，超直覺

終端效率

brew "fzf"          # 模糊搜尋，找檔案、切分支都靠它
brew "ripgrep"      # 比 grep 快 10 倍的搜尋
brew "zoxide"       # 智慧 cd，記住你常去的目錄
brew "starship"     # 好看又實用的 shell prompt
brew "tmux"         # 終端分割、session 管理

開發工具

brew "fnm"          # Node.js 版本管理（比 nvm 快）
brew "jq"           # JSON 處理
brew "direnv"       # 自動載入 .envrc 環境變數
brew "just"         # 比 Makefile 好讀的 task runner

桌面 App

cask "visual-studio-code"    # 編輯器
cask "iterm2"                # 終端機
cask "rectangle"             # 視窗管理
cask "alfred"                # 啟動器

日常維護指令

# 產生/更新 Brewfile（加 --force 覆寫舊檔）
brew bundle dump --force --file=~/Brewfile

# 安裝 Brewfile 裡的所有套件
brew bundle install --file=~/Brewfile

# 檢查哪些已安裝但不在 Brewfile 裡
brew bundle cleanup --file=~/Brewfile

# 更新所有套件
brew update && brew upgrade

一個小提醒

brew bundle dump 預設會把 VS Code extensions 也列進去。如果你已經開了 VS Code 的 Settings Sync，這些行就是多餘的，加 --no-vscode 跳過：

brew bundle dump --force --no-vscode --file=~/Brewfile

這部分我在另一篇文章有詳細說明。

下一步

Brewfile 搞定之後，你可能會想：那 .zshrc、.gitconfig 這些 dotfiles 怎麼辦？推薦搭配 chezmoi 一起使用，把整個開發環境都版本控制起來。這部分我在系列的下一篇會詳細介紹。