Homebrew 无法真正一键恢复,但可通过 Brewfile 或列表文件批量重装实现接近一键效果;需提前导出环境快照,推荐用 brew bundle dump 生成 Brewfile,再执行 brew bundle install 还原 formula、cask、tap 及服务配置。
mac 上不能真正“一键”恢复 homebrew 软件,但可以通过提前导出的清单文件(brewfile 或 brew bundle 列表)快速批量重装,接近一键效果。关键在于你是否已保存过当前环境的完整快照。
先确认你有没有现成的清单文件
Homebrew 本身不自动创建清单,需手动导出。如果你之前执行过以下任一操作,就已有可用清单:
- 用 brew bundle dump 生成过
Brewfile(推荐方式,含 cask、tap、服务等全量信息) - 用 brew list --formula > formulas.txt 和 brew list --cask > casks.txt 分别保存过列表
- 用 brew bundle exec bash -c 'brew list' 配合脚本做过环境归档
如果没有,那就得先在当前机器上补做一次导出,再迁移到新机或重装后使用。
用 Brewfile 恢复(最完整、推荐)
Brewfile 是 Homebrew Bundle 定义的标准清单格式,能还原 formula、cask、tap、甚至 brew services 启动项。
- 确保已安装 brew bundle:
brew tap homebrew/bundle - 若已有
Brewfile(通常放在项目根目录或~/.Brewfile),运行:brew bundle install - 想从指定路径读取:
brew bundle install --file=/path/to/Brewfile
它会自动跳过已安装项,只装缺失的;遇到冲突(如版本不兼容)会提示,不会强制覆盖。
用纯列表文件恢复(简单直接)
适合只有基础 formula/cask 名单、不依赖复杂配置的场景:
- 恢复命令行工具(formula):
brew install $(cat formulas.txt) - 恢复图形应用(cask):
brew install --cask $(cat casks.txt) - 合并执行(注意顺序:先 formula 后 cask,避免依赖问题):
brew install $(cat formulas.txt) && brew install --cask $(cat casks.txt)
⚠️ 注意:列表文件每行一个包名,不能含注释或空行;如有带版本号的包(如 node@18),需确保该版本 formula 仍可用。
恢复前建议做的几件事
不是必须,但能显著提升成功率和体验:
- 运行
brew update更新本地 formula 索引,避免因索引过旧导致包找不到 - 检查网络——国内用户务必已配置镜像源(如中科大或清华),否则下载极慢甚至失败
- 确认 Xcode 命令行工具已安装:
xcode-select --install - 如涉及 GUI 应用(如 wechat、qq),首次安装可能需手动授权“辅助功能”或“完全磁盘访问”
恢复过程无需人工干预,但大型软件(如 visualstudio-code、docker)耗时较长,可后台运行。

















