如果你在 macOS 上经常安装命令行工具、开发语言运行时、开源小工具，或者想把“新电脑装机”变成一件可复用的事情，Homebrew 是最省心的入口。它把软件的下载、校验、安装、升级、卸载都做成了统一命令，并且能用清单文件把你的常用工具固化下来，方便在多台 Mac 之间同步。
开始前建议确认两点：1）macOS 版本尽量保持较新；2）你有一个可用的网络环境（能正常访问 GitHub 等站点），否则安装与下载阶段可能会变慢或失败。
Homebrew 官方首页：https://brew.sh/。安装命令会随时间更新，以下是常见写法（以官方为准）：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"安装完成后，终端里会提示你把 brew 加入环境变量。不同芯片路径不同：Apple Silicon 通常在 /opt/homebrew，Intel 通常在 /usr/local。如果你不确定，直接运行：
which brew brew --version最常用的几条命令建议记住，日常维护也更稳：
brew update brew upgrade brew install <formula> brew uninstall <formula> brew cleanup brew doctor其中 brew doctor 会做环境自检，遇到权限、路径、残留文件等问题时，先跑它能少走弯路。安装 GUI 应用（cask）也很常见，例如：
brew install --cask iterm2 brew install --cask visual-studio-codeHomebrew 的下载主要涉及两类：1）源码（Git 仓库）；2）预编译包（bottle）。变慢通常不是 Homebrew 本身问题，而是网络链路不稳定或访问受限。
更通用、也更可控的做法是：在系统层或终端层使用稳定的代理/VPN，让终端能可靠访问 GitHub。对于 bottle 下载，Homebrew 也支持通过环境变量指定下载域名（适合你有公司内网缓存或自建下载站的情况）：
export HOMEBREW_BOTTLE_DOMAIN="https://your.bottle.domain"这类配置属于“按你的网络环境定制”，不建议盲目照抄陌生镜像地址。官方文档可以作为参考入口：https://docs.brew.sh。
当你装好一套趁手的软件后，最怕的就是换电脑/重装系统要重新回忆“我到底装了啥”。Brewfile（配合 brew bundle）就是为这个场景准备的：把你的工具列表写成清单，放进 Git 或同步盘，随时复用。
先把当前已安装的内容导出成 Brewfile：
brew tap Homebrew/bundle brew bundle dump --file=./Brewfile --describe --force一个简化的 Brewfile 长这样（示例）：
tap "homebrew/cask" brew "git" brew "wget" brew "ripgrep" cask "iterm2" cask "visual-studio-code"在新电脑上，把 Brewfile 放到任意目录，运行：
brew bundle --file=./Brewfile它会按清单自动安装缺失项。你也可以在团队里维护一份“基础工具 Brewfile”，让新同事开机后更快进入状态。
1）提示权限问题：尽量不要用 sudo brew ...，而是按 Homebrew 的建议修复目录权限或重新初始化。
2）PATH 找不到 brew：按照安装输出，把相应的 eval 行写进你的 shell 配置（如 ~/.zprofile 或 ~/.zshrc），然后重开终端。
3）升级后有残留：运行 brew cleanup 清理旧版本；遇到“keg-only”或冲突提示，先阅读输出再决定是否链接。
更多命令说明可以查看 manpage：https://docs.brew.sh/Manpage。
