Homebrew（简称 brew）是 macOS 上常用的软件包管理器。它可以把“下载安装到哪、版本怎么管、升级卸载怎么做”这些重复劳动变成统一命令，让你的开发/办公环境更可控、更好迁移。
适用场景：安装命令行工具（git、wget）、运行环境（node、python）、数据库（mysql、postgresql）、以及常见桌面软件（通过 cask）。
1）确保 macOS 已更新到较新的版本，并有管理员权限。
2）准备稳定网络。若公司网络有代理/网关限制，先确认终端能正常访问 GitHub 与 Homebrew 相关域名；必要时按你所在网络的规范配置代理（不要随意使用来源不明的“加速脚本”）。
3）安装 Command Line Tools（如果系统提示缺失会自动引导）：
xcode-select --install建议使用官方安装命令（以 Homebrew 官网为准）。安装完成后，通常需要把 brew 的环境变量写入 shell 配置，让新开终端可用：
# Apple Silicon 常见路径（示例） # 将这一段按安装提示加入 ~/.zprofile 或 ~/.zshrc eval "$(/opt/homebrew/bin/brew shellenv)"验证：
brew --version brew doctorbrew doctor 若有警告，先读清楚提示再处理，避免“一键修复”导致路径混乱。
建议习惯：每隔一段时间 update + upgrade，再 cleanup 保持整洁。
如果你不想每次换电脑都重装一遍软件，Brewfile 是最省心的方法之一。
1）从当前电脑导出清单：
brew bundle dump --describe --force这会生成一个 Brewfile（可放进你的私有仓库/备份目录）。
2）在新电脑上进入 Brewfile 所在目录，执行：
brew bundle它会按清单自动安装依赖与应用。你还可以把“公司/个人两套清单”分别管理，切换更轻松。
遇到 curl: (7)、Connection reset、下载卡住等问题，建议按顺序排查：
1）先确认 DNS、代理、系统时间是否正常；企业网络可能需要走指定代理。
2）查看当前 brew 配置：
brew config3）尽量优先遵循官方文档与公司网络规范，不要复制来历不明的“镜像替换脚本”。如果需要使用镜像/代理，建议只改动你理解且可回滚的部分，并记录变更。
1）提示权限问题：不要直接把整个目录 chmod 777。优先按提示修复目录所有者、检查 shellenv 是否正确。
2）出现大量警告：先运行 brew doctor 并逐条处理；很多问题来自 PATH 重复、旧版本残留或手动安装的软件冲突。
3）安装成功但命令不可用：多半是 PATH 没生效。确认 shell 配置文件中 shellenv 放在合适位置，并重启终端或 source 配置。
卸载某个软件：
brew uninstall <包名>卸载桌面软件（cask）：
brew uninstall --cask <应用名>清理旧版本与缓存：
brew cleanup1）用 Brewfile 管理环境，让装机与迁移可复现。
2）改网络/代理/镜像前先理解改动，保留回滚方案。
3）遇到问题先 brew doctor + brew config，再针对性处理。
按这套流程，你的 macOS 环境会更稳定、更省时间。
