Homebrew Bundle 是 Homebrew 的一个扩展能力：用一个 Brewfile 把你安装过的包、GUI 应用（cask）、以及可选的 Mac App Store 应用（mas）记录成“可复现清单”。重装或换电脑后，按清单一键恢复。
参考：https://github.com/Homebrew/homebrew-bundle（Bundle 项目）
如果你已经装过 Homebrew，可以跳过安装。Homebrew 官网：https://brew.sh/
在终端检查：
brew --version
多数情况下 brew bundle 已内置可用；如提示缺失，更新一次：
brew update
推荐在一个专门的目录里维护，例如 ~/dotfiles 或 ~/Brewfile。
生成命令（会把当前已安装内容写入 Brewfile）：
brew bundle dump --describe --force
几个实用参数说明：
--describe：尽量带上简短说明，未来回看更容易。
--force：覆盖已有 Brewfile（谨慎使用，建议先备份或用 Git 管理）。
直接 dump 出来的清单往往偏长。你可以按用途分组：开发必备、日常工具、可选应用。
常见写法示例（注意这只是结构示意，按你自己的实际软件调整）：
tap "homebrew/cask"
brew "git"
brew "ripgrep"
cask "raycast"
如果你要同步 Mac App Store 应用，可选安装 mas 并在 Brewfile 里记录（需要 Apple ID 登录）：
brew install mas
mas "Xcode", id: 497799835
把 Brewfile 同步到新机器后，在 Brewfile 所在目录执行：
brew bundle
它会按清单安装缺失项目。你也可以先做“预演”查看将要发生什么：
brew bundle check
1）某些 cask 安装失败：先确认系统权限与网络环境，或用 brew install --cask 应用名 单独重试定位问题。
2）公司/家用两台机器差异：把可选软件单独拆成第二份 Brewfile（或用 Git 分支/注释管理），避免“所有机器都装一遍”。
3）担心清单不可控：建议把 Brewfile 放进 Git 仓库，每次改动都能回滚对比。
当你把 Brewfile 当成“环境说明书”，就能把 macOS 的软件安装与配置从一次性手工劳动，变成可重复、可审计、可迁移的流程。建议每隔一段时间重新 dump 一次并人工精简，让清单始终贴近你的真实工作流。
