macOS Homebrew版本冲突本质是系统路径、符号链接与运行时依赖未对齐；需先用which、echo $PATH、dyld_print_libs定位真实生效版本，再brew unlink/link切换目标版本，确保PATH中Homebrew路径优先，并可选nvm/pyenv/Valet实现项目级隔离。
macos 上 homebrew 的版本冲突，本质不是“装了多个版本”，而是系统路径、符号链接和运行时依赖三者没对齐。解决的核心是：先看清谁在生效，再按需切换，最后验证是否真被调用。
第一步：确认当前实际生效的版本
别急着重装或 unlink，先查清楚终端里真正跑的是哪个：
- 运行 which php、which node 或 which python3，看输出路径是
/usr/bin（系统）、/opt/homebrew/bin（Apple Silicon）还是/usr/local/bin（Intel） - 执行 echo $PATH，检查这些路径的顺序——排最前面的才会被优先找到
- 对报错命令加调试参数，比如 dyld_print_libs=1 php -v 2>&1 | grep ssl，能直接看到运行时加载的是哪个 OpenSSL 库
第二步：清理并重新链接目标版本
Homebrew 默认只允许一个版本通过 brew link 激活。如果安装了多个 PHP 或 Node 版本，但 php -v 还是旧的，大概率是链接没切过去：
- 先取消现有链接：brew unlink php@7.4（替换成你当前链接的版本）
- 再强制链接目标版本：brew link --force --overwrite php@8.2
- 若提示
Target /usr/local/bin/php already exists，说明有残留文件，可先手动删：rm /usr/local/bin/php，再重试 link
第三步：确保 PATH 正确且不被覆盖
即使 brew link 成功，如果 /usr/bin 在 PATH 里排得比 /opt/homebrew/bin 靠前，系统仍会优先调用老旧的系统版本：
- 编辑 ~/.zprofile（GUI 终端如 VS Code 默认读这个），开头加入：
export PATH="/opt/homebrew/bin:$PATH"（Apple Silicon）或 export PATH="/usr/local/bin:$PATH"（Intel） - 删掉
~/.zshrc中重复的 PATH 设置，避免多头写入导致混乱 - 新开一个终端窗口（不是新标签页），再运行 which php 和 php -v 验证
第四步：隔离项目级需求（可选但推荐）
如果你同时开发多个项目，分别需要 PHP 7.4 和 PHP 8.2，硬切全局版本并不高效。建议搭配工具实现自动切换：
- PHP 项目：用 Laravel Valet，它能根据当前目录下的
.valet/配置或valet use php@8.2命令自动路由请求 - Node.js 项目：用 nvm，执行 nvm install 18.19.0 && nvm use 18.19.0，每个项目可独立指定版本
- Python 项目：用 pyenv + venv，pyenv local 3.11.9 会在当前目录生成
.python-version文件，自动生效
