Homebrew 是 macOS 上最常用的包管理器之一，适合把「开发工具、命令行软件、依赖库」统一交给一套可追溯的命令管理。相比到处下载安装包，它的优点是：可批量安装、可一键升级、可快速排查环境问题。
官网与文档（参考链接）：https://brew.sh/；Manpage：https://docs.brew.sh/Manpage
1) 打开 Terminal，执行安装脚本：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
2) 安装完成后，按提示把 brew 加到 PATH。常见两种情况：
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"
或（部分 Intel 机型）：
echo 'eval "$(/usr/local/bin/brew shellenv)"' >> ~/.zprofile
建议安装后先跑一轮自检，能提前发现 Xcode Command Line Tools、权限、路径等问题：
brew --version
brew doctor
如果提示缺少命令行工具，可先安装：
xcode-select --install
网络环境不佳时，Homebrew 的「源码拉取」「Bottle 下载」可能会慢。这里给出几个合规思路（不涉及破解/绕过付费）：
1) 优先使用 Bottle（二进制包）而不是从源码编译：大多数情况下 Homebrew 会自动选择 Bottle；如果你看到大量编译日志，说明可能在走源码路径。
2) 关注网络与 DNS：公司网络/代理/VPN 可能影响 GitHub 访问；可以尝试切换网络或调整 DNS（例如 1.1.1.1 / 8.8.8.8）。
3) 仅在你信任且合规的前提下配置 Bottle 下载域名（示例变量名，具体以官方文档为准）：
export HOMEBREW_BOTTLE_DOMAIN="https://example-mirror.invalid"
提醒：镜像来源请自行甄别，避免使用不明第三方。
下面是一个偏通用的「新机开发环境」安装组合，你可以按需删改：
brew install git wget curl
brew install ripgrep fd
brew install tree htop
brew install python
brew install node
brew install ffmpeg
查看某个软件的详情与可选项：
brew info <formula>
搜索包名：
brew search <keyword>
把下面 3 条当成固定流程就行：
brew update
brew upgrade
brew cleanup
如果想只升级某个软件：
brew upgrade <formula>
查看哪些包需要升级：
brew outdated
1) PATH 优先级：如果你同时装了多个版本的同名工具（比如 Python/Node），建议明确 PATH 的顺序，避免「明明升级了但版本没变」。
2) 依赖冲突：遇到安装失败，先看提示里是否有冲突的旧版本；必要时先卸载旧包再装新包。
3) 权限问题：尽量不要用 sudo 去跑 brew；如果历史上用 sudo 装过，可能需要修复目录权限。
