关键不是解决冲突而是避免冲突：靠路径隔离、动态路由和作用域分层，PATH顺序决定命令优先级，必须前置pyenv/nvm等管理器路径，禁用手动硬编码版本路径，各工具用专属机制（pyenv/nvm/java17函数等）分治，验证时须检查which、sys.executable和PATH前段。
macos 上 zsh 配置多版本共存，关键不是“解决冲突”，而是避免冲突——靠路径隔离、动态路由和作用域分层，不让不同版本的命令互相覆盖。
PATH 顺序决定谁生效，必须前置管理器路径
zsh 启动时按 PATH 从左到右查找命令。若把 /usr/bin 或 /opt/homebrew/bin 放在 pyenv/nvm 前面，系统或 Homebrew 安装的 Python/Node 就会优先被调用，导致版本“看似安装了却切不动”。
正确做法是：
- Homebrew 安装后立即执行：
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc - pyenv 初始化三行严格按顺序写入：
export PYENV_ROOT="$HOME/.pyenv"<br> export PATH="$PYENV_ROOT/bin:$PATH"<br> eval "$(pyenv init -zsh)"
- 不要手动把
~/.pyenv/versions/3.12.5/bin加进 PATH ——这会绕过 pyenv 的 shim 机制，失去自动路由能力
各工具用各自机制，不混用 PATH 硬编码
Python、Node.js、Java、PHP 各有成熟方案，统一靠 PATH 切换反而容易打架：
-
Python：用
pyenv local 3.12.5（项目级）或pyenv global 3.11.9，靠~/.pyenv/shims/python拦截调用 -
Node.js：用
nvm install 20.15.0 && nvm use 20.15.0，nvm 自动重写 PATH -
Java：不改 PATH，只设
JAVA_HOME，配合函数切换：java17() { export JAVA_HOME=$(/usr/libexec/java_home -v 17); echo "→ Java 17"; } -
PHP：用 Homebrew 多版本 tap（如
shivammathur/php），通过brew unlink php && brew link --force php@8.2切换，再确保/opt/homebrew/opt/php@8.2/bin在 PATH 前段
验证是否真生效，别只看 version
光运行 python --version 不够，容易被缓存或 alias 干扰。每次切换后务必检查：
-
which python→ 应输出~/.pyenv/shims/python（不是/usr/bin/python3或/opt/homebrew/bin/python） -
python -c "import sys; print(sys.executable)"→ 应指向~/.pyenv/versions/3.x.x/bin/python -
echo $PATH | tr ':' '\n' | head -5→ 前几行应含$PYENV_ROOT/bin、/opt/homebrew/bin，不含/usr/local/bin或/usr/bin（除非你明确需要）
Shell 配置文件要干净，避免重复加载
常见问题：多个地方写入了 pyenv init 或 nvm.sh，导致 shim 被覆盖、PATH 叠加错乱。
建议操作：
- 用
grep -n "pyenv\|nvm\|JAVA_HOME" ~/.zshrc检查是否有重复段 - 删除所有手动添加的
export PATH="...:/usr/local/bin:..."类语句（Homebrew 和 pyenv 已接管） - 确保只在
~/.zshrc中配置，不要同时往~/.zprofile或~/.bash_profile写同类内容 - 修改后运行
source ~/.zshrc，再新开终端验证，避免残留状态干扰
