Homebrew在Apple Silicon和Intel Mac上安装路径与架构严格对应：Apple Silicon默认装在/opt/homebrew（arm64），Intel装在/usr/local（x86_64），路径错配会导致brew command not found、软件无法安装等问题，需通过uname -m、which brew、file $(which brew)及PATH顺序逐层验证并清理残留。
homebrew 在 apple silicon（m1/m2/m3）和 intel mac 上使用完全不同的安装路径与运行环境，架构不匹配不是“报错就完事”的小问题，而是会导致命令找不到、软件装不上、甚至整个 brew 失效。排查关键不在猜，而在验证终端、homebrew 本身、以及你要装的包三者是否同属 arm64 或 x86_64。
确认当前终端运行的 CPU 架构
打开终端，直接运行：
uname -m
结果是 arm64 → 你正在原生 ARM 模式下运行
结果是 x86_64 → 你正通过 Rosetta 2 模拟运行（即使机器是 M 系列芯片）
再补查一句：
arch
输出应与 uname -m 一致。如果不一致，说明 shell 环境被手动修改过，需进一步检查启动配置文件（如 ~/.zshrc 是否误加了 arch -x86_64）。
验证 Homebrew 安装路径与架构是否对应
运行：
which brew
结果为 /opt/homebrew/bin/brew → 是 Apple Silicon 版，只支持 arm64
结果为 /usr/local/bin/brew → 是 Intel 版，只支持 x86_64
如果终端是 arm64，但 which brew 返回 /usr/local/bin/brew，说明你装错了版本，或旧版残留干扰了 PATH；反之亦然。
进一步确认 brew 自身架构：
file $(which brew)
输出中应含 arm64 或 x86_64 字样，且必须与 uname -m 结果一致。若显示 Mach-O 64-bit executable x86_64 却在 arm64 终端里运行，就是典型架构错配。
检查要安装的软件是否支持当前架构
某些公式（Formula）尚未适配 Apple Silicon，尤其交叉编译工具或老旧 C 库。常见报错如：
Error: cannot install under rosetta 2 in arm default prefixNot supported on this architectureFailed to download bottle for aarch64
这时别急着重装，先查官方支持状态：
brew info [包名]（例如 brew info aarch64-linux-gnu-gcc）
看输出里的 Available on: 行，是否包含 arm64_big_sur、arm64_monterey 等字样。
也可临时跳过 bottle（预编译二进制），强制源码编译测试兼容性：
brew install --build-from-source [包名]
如果编译成功，说明只是缺少对应架构的 bottle，不是根本性不兼容。
清理错配残留，避免 PATH 混乱
常见陷阱：Intel 时代装过 Homebrew，升级到 M 系列后没卸载旧版，PATH 中仍保留 /usr/local/bin，导致系统优先找到旧版 brew。
检查 PATH 顺序：
echo $PATH
确保 /opt/homebrew/bin（Apple Silicon）或 /usr/local/bin（Intel）排在最前面。若不是，修改 ~/.zshrc 或 ~/.zprofile，把对应行移到顶部，例如：
export PATH="/opt/homebrew/bin:$PATH"
改完执行 source ~/.zshrc，再重新验证 which brew 和 brew --version。
如有旧版残留，可手动清理：
- 删掉
/usr/local/bin/brew及其关联目录（/usr/local/Homebrew、/usr/local/share/zsh/site-functions/_brew等） - 删掉
/opt/homebrew下的旧 symlink（如有） - 运行 brew doctor，它会明确提示 “Your system is ready to brew.” 才算真正干净
