phpenv 不支持 Node.js 版本管理，它仅用于 PHP；Node.js 应使用 nvm（或 nvm-windows），二者初始化逻辑、PATH 管理和版本文件互不兼容，混用会导致命令失效、PATH 冲突和 shim 错乱。
phpenv 不支持 Node.js 版本管理 —— 它只管 PHP。
如果你看到“phpenv 安装 Node.js”或“phpenv + nvm 混用教程”，那是混淆了两个完全无关的工具：phpenv 是 PHP 版本管理器，专为 php、composer 等 PHP 生态命令服务；nvm（或 Windows 下的 nvm-windows）才是 Node.js 的版本管理器，只作用于 node、npm。
强行把两者混用，不仅无法切换 Node.js 版本，还会导致 PATH 冲突、命令失效、shim 错乱等实际问题。
为什么 phpenv init 不能加载 nvm？
phpenv init - 输出的是专为 PHP shims 设计的 shell 配置片段，它只注入 ~/.phpenv/shims 到 PATH，并监听 .php-version 文件。
而 nvm 的初始化逻辑（nvm init）依赖自身独立的 NVM_DIR、~/.nvm/versions/node 结构和 shell 函数封装（如 nvm use），二者不共享任何状态或钩子。
-
phpenv不识别node命令，也不会重写node的执行路径 -
nvm不读取.php-version，也不关心phpenv local设置 - 同时启用两者的
eval "$(xxx init -)"会互相覆盖 PATH 或函数定义，常见现象是：-
node -v报错command not found -
phpenv versions正常，但nvm list显示空或报错 - 终端重启后只有其中一个生效，另一个“消失”
-
nvm-windows 在 Windows 上必须彻底卸载旧 Node
这是最常被跳过的致命步骤，直接导致nvm install 成功但 nvm use 无效（版本前无 *）。
- 卸载控制面板里的 Node.js（含所有残留条目）
- 删除以下全部路径（即使看起来不存在也要确认）：
C:\Program Files\nodejsC:\Program Files (x86)\nodejs%APPDATA%\npm%APPDATA%\npm-cache%USERPROFILE%.npmrc - 清理环境变量：
从PATH中删掉所有含nodejs的条目
删除系统变量中的NODE_PATH - 最后在新 CMD 中运行
where node和where npm，返回为空才表示干净
不执行这一步，nvm use x.x.x 会静默失败，始终调用旧安装的 node.exe。
立即学习“PHP免费学习笔记（深入）”；
macOS/Linux 用户别用 nvm + phpenv 共享同一 shell 初始化
很多教程建议把eval "$(phpenv init -)" 和 export NVM_DIR=... + [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh" 全塞进 ~/.zshrc，但这有顺序陷阱：
- 如果
nvm.sh加载在phpenv init之后，它可能覆盖PATH中的~/.phpenv/shims - 如果
phpenv init在后，它又会把~/.phpenv/shims插到最前，导致node命令被 shim 截获并报错（因为 shims 目录下根本没有node）
正确做法是：
- 两者都加载，但确保
nvm.sh的函数定义（如nvm、nvm use）可用 - 同时保证
~/.phpenv/shims和~/.nvm/versions/node/*/bin都在PATH中，且 *~/.nvm/versions/node//bin 在~/.phpenv/shims之前**（否则node被 phpenv shim 拦截） - 验证方式：运行
echo $PATH，确认nvm的 bin 路径出现在phpenvshims 路径左侧
复杂点在于：每次 nvm use 会动态修改 PATH，而 phpenv 的 shims 是静态前置的 —— 这个耦合没有官方支持，纯靠手动调序维持。
你真正需要的不是“phpenv 管 Node”，而是明确区分用途：PHP 用 phpenv，Node 用 nvm（或 nvm-windows），各自初始化、各自配置、各自维护。任何试图让一个工具代理另一个工具职责的做法，都会在项目深入后暴露路径冲突、命令覆盖、调试困难等问题。
