如果你刚装好 macOS，准备搭建常用软件与开发环境，或者你已经装了 Homebrew 但经常遇到下载慢、路径找不到、权限报错，这篇就够用：从安装到验证，再到加速思路与常用命令速查，按步骤做完就能稳定使用。
Homebrew 是 macOS 上最常用的包管理器之一，用来安装、更新、卸载软件与命令行工具。它把“安装流程”变成了一条命令，另外还能把软件版本、依赖关系和升级维护统一起来，避免手工下载与拖拽造成的混乱。
建议先做两件事：
1) 确认系统版本与芯片架构（Intel / Apple Silicon）。
2) 确认终端可用（系统自带 Terminal 或 iTerm2 都可以）。
你可以用下面命令查看架构：
uname -m
常见输出：arm64（Apple Silicon）或 x86_64（Intel）。这会影响 Homebrew 默认安装目录（后文会验证）。
建议以官方脚本为准，确保安装过程和后续升级逻辑一致。打开终端，执行：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
安装过程会提示输入 macOS 登录密码（用于写入系统目录/权限配置），属于正常行为。安装完成后，用下面命令验证：
brew --version
若能看到版本号，说明基础安装成功。
很多人装完后遇到 command not found: brew，本质是 shell 没把 brew 的路径加入环境变量。根据你的机器类型，Homebrew 可能在不同目录：
Apple Silicon 常见：/opt/homebrew/bin/brew
Intel 常见：/usr/local/bin/brew
你可以直接用绝对路径确认：
/opt/homebrew/bin/brew --version
如果这条能跑通，再把它写入当前 shell 的配置。以 zsh 为例：
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"
然后重新打开终端，再执行 brew --version 检查是否生效。
Homebrew 的瓶颈通常来自网络访问 GitHub / 源站的速度。这里提供的是“公开镜像/网络加速”的通用思路，不涉及任何破解、绕过付费或入侵行为：
1) 优先使用更稳定的网络环境（公司/校园/家庭宽带差异很大）。
2) 了解可用的镜像说明与配置指引（不同地区/时间镜像策略会变化）。
3) 遇到某个包特别慢时，先尝试更换下载源或稍后重试，避免在高峰期反复失败。
参考链接（可查镜像说明与使用建议）：
https://mirrors.tuna.tsinghua.edu.cn/help/homebrew/
更新 Homebrew 自身：
brew update
升级已安装的软件：
brew upgrade
搜索软件包：
brew search <keyword>
安装命令行工具（formula）：
brew install <name>
安装图形应用（cask）：
brew install --cask <name>
查看已安装列表：
brew list
查看某个包的安装信息与依赖：
brew info <name>
卸载：
brew uninstall <name>
清理旧版本与缓存（节省空间）：
brew cleanup
诊断当前环境（遇到奇怪报错先跑它）：
brew doctor
1) 先确认 PATH：终端里 which brew 是否能定位到正确路径。
2) 再确认网络：如果大量下载超时，先换网络环境或降低并发重试。
3) 再跑诊断：brew doctor 会给出可执行的修复建议（例如权限、残留文件等）。
4) 最后再考虑重装：多数问题通过修复 PATH、更新/清理即可解决，重装不是第一步。
Homebrew 官网：
