Homebrew 命令速查表 - macOS 包管理常用命令大全
换台新 Mac，$PATH 与依赖装得乱，半天就没了，而 Homebrew 能把这些收敛成可复现的命令。本表覆盖公式的安装/更新/卸载、Cask GUI 应用、brew services 管理后台服务、国内源切换，以及依赖查看与问题排查。不是简单罗列包名，而是告诉你该用哪个 flag 装 HEAD 分支还是预编译 bottle、以及 brew doctor 报错该怎么定位。读完基本能靠终端完成一套 Mac 工具链的搭建与修复。
基础操作 12
brew install wget安装命令行工具
brew uninstall wget卸载
brew update更新 Homebrew 自身
brew upgrade升级所有已安装包
brew upgrade wget升级指定包
brew list列出已安装的公式，核对某包是否已装、装了哪些版本
brew info wget查看包信息（版本、依赖、caveats），装之前先确认依赖是否符合预期
brew search nginx搜索可用包，不确定准确名字时先模糊搜一遍
brew cleanup清理旧版本缓存，磁盘紧张时先跑这个释放空间
brew outdated查看可升级的包，升级前先评估是否有破坏性更新
brew reinstall wget重新安装（修复损坏）
brew autoremove自动清理不再需要的依赖
Cask GUI 应用 5
brew install --cask visual-studio-code安装 GUI 应用
brew uninstall --cask visual-studio-code卸载 GUI 应用
brew list --cask列出已安装 GUI 应用
brew search --cask chrome搜索 GUI 应用
brew upgrade --cask升级所有 GUI 应用
服务管理 5
brew services list列出所有服务状态
brew services start mysql启动并加入开机自启
brew services stop mysql停止服务
brew services restart mysql重启服务
brew services run mysql启动但不加入开机自启
源与 Tap 5
brew tap homebrew/cask-fonts添加第三方仓库
brew untap homebrew/cask-fonts移除第三方仓库
brew tap列出已添加的 tap
export HOMEBREW_API_DOMAIN="https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles/api"临时切换 API 源
export HOMEBREW_BOTTLE_DOMAIN="https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles"临时切换 Bottle 源
问题排查 7
brew doctor检查环境问题
brew config查看 Homebrew 配置
brew deps wget查看依赖关系
brew pin wget锁定版本不升级
brew unpin wget解除锁定
brew leaves查看顶层手动安装的包
brew uses --installed wget查看哪些已安装包依赖它
Bundle 批量管理 Bundle 4
brew bundle dump导出已安装列表到 Brewfile
brew bundle install从 Brewfile 批量安装
brew bundle cleanup清理 Brewfile 中未列出的包
brew bundle check检查是否满足 Brewfile 依赖
提示
- 国内网络建议先换源再 install，否则 bottle 下载经常超时。
- brew services 管理的服务 plist 在 ~/Library/LaunchAgents/，出问题先看那里。
- brew cleanup 会删除旧版本和下载缓存，磁盘紧张时跑一下。
由 巧匠 维护
公开更新于 2026年7月21日，内容持续校对官方文档。