Homebrew 依赖 macOS 的命令行工具（Command Line Tools）。首次安装前先确认系统版本与网络环境正常，并准备好一个具备管理员权限的账号。
安装命令行工具：xcode-select --install
Homebrew 官网：https://brew.sh/（页面会给出最新的官方安装命令）。
通用安装命令（以官网为准）：/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
Apple Silicon 机型通常安装到 /opt/homebrew，Intel 机型多为 /usr/local。如果安装完成后终端提示找不到 brew，可以执行：
Apple Silicon：echo "eval "$(/opt/homebrew/bin/brew shellenv)"" >> ~/.zprofile
然后重新打开终端，或执行：eval "$(/opt/homebrew/bin/brew shellenv)"
安装软件：brew install wget
安装图形应用：brew install --cask google-chrome
更新仓库与软件：brew update / brew upgrade
清理旧版本：brew cleanup
查看软件信息：brew info wget
搜索：brew search ffmpeg
1) 先确认 DNS/代理是否可用，网络波动会直接影响 brew update 与下载瓶装包（bottles）。
2) 了解 Homebrew 的下载机制与可配置项：Manpage/环境变量参考：https://docs.brew.sh/Manpage
3) 尽量优先安装 bottles（预编译包）。如果遇到必须编译的公式，准备好编译依赖并给终端留足时间。
自检：brew doctor（会给出可操作的修复建议）。
更新卡住或报错时：brew update --verbose 便于定位是 Git 拉取还是下载阶段。
权限相关问题（例如目录不可写）通常需要按提示修复目录属主/权限；不要随意用不明来源脚本修改系统目录。
如果你经常在多台 Mac 间迁移环境，可以把常用软件列表固化成一份清单，重装时批量执行 brew install / brew install --cask，效率会高很多。
