Homebrew 是 macOS 上最常用的软件包管理器。官方安装说明见：https://brew.sh。
通常按官网给出的命令安装即可。安装完成后，建议先确认版本与环境是否正常：
brew -v
brew doctor
Homebrew Bundle（项目页：https://github.com/Homebrew/homebrew-bundle）允许你用一个 Brewfile 声明要安装的内容，包括：
brew：命令行工具（formula）
cask：桌面应用（如浏览器、剪贴板工具）
mas：Mac App Store 应用（可选，需要登录 App Store）
把这些写进同一份文件后，就能在新 Mac 上重复执行，做到“可迁移、可追溯、可更新”。
建议在你的常用目录（例如 ~/Dev/dotfiles 或任意同步盘）创建 Brewfile。下面是一份尽量通用的示例（按需删改）：
tap "homebrew/bundle"
brew "git"
brew "wget"
brew "jq"
cask "google-chrome"
cask "visual-studio-code"
cask "iterm2"
如果你要管理“开发环境版本”（如 Node/Python），也可以写入对应工具的 cask 或 brew 包，但注意团队/个人习惯不同，别把不确定的依赖强塞给所有机器。
在 Brewfile 所在目录执行：
brew bundle
它会按 Brewfile 安装缺失项。要更稳妥一点，先预览将要做的事情：
brew bundle check
当你在新机器上跑完后，后续维护可以配合 Homebrew 的更新流程：
brew update
brew upgrade
如果你希望严格对齐 Brewfile（例如不在清单里的 cask 不要留下），可以了解 Bundle 的清理能力，但在执行前务必确认不会误删你临时安装的工具。
如果你已经用 Homebrew 装了很多东西，最省事的方式是直接导出：
brew bundle dump --describe --force
它会在当前目录生成/覆盖 Brewfile，并带上说明。导出后建议人工清理一遍：把不需要跨设备同步的项目删掉（比如一次性的调试工具）。
1）把 Brewfile 和你的 dotfiles 放一起，并用 Git 管理版本；这样每次改动都有记录。
2）App Store（mas）条目依赖账号登录，适合个人设备，不建议强行塞进团队公共清单。
3）不同芯片（Intel/Apple Silicon）在路径上可能不同，尽量用 Homebrew 自己的方式处理环境变量，避免硬编码。
4）遇到安装失败，先看输出日志，再单独安装对应条目定位问题；不要用“绕过校验/破解”之类不合规方式处理。
