phpenv仅管理PHP版本，不支持Node.js；Node.js版本应使用nvm管理，二者可共存但需正确配置shell初始化顺序。
phpenv 本身不支持管理 Node.js 版本 —— 它只管 PHP。想用 phpenv 配置或集成 Node.js，属于工具误用，硬凑会出问题。
如果你看到网上有“phpenv + nodejs”组合教程，大概率是混淆了 phpenv 和 nvm（Node Version Manager），或者把两个独立环境强行 symlink 到一起，结果版本切换错乱、npm 找不到对应 node、全局模块失效。
为什么 phpenv 不能装/切 Node.js
phpenv 的设计目标非常明确：只接管 php、phpize、php-config 等 PHP 相关二进制和路径。它的插件系统（如 php-build）也只处理 PHP 源码编译逻辑，对 Node.js 的构建依赖（Python、make、libssl-dev 等）、V8 版本约束、npm 与 node 的绑定关系完全无感知。
强行修改 phpenv 的 shims 或 versions 目录去塞入 Node 二进制，会导致：
立即学习“PHP免费学习笔记（深入）”；
-
node -v显示版本，但npm -v报错 “Cannot find module ‘npm’” - 切换 PHP 版本时意外触发 Node 路径重写，
which node指向一个不存在的路径 -
phpenv rehash清掉你手动加的 Node shim
Node.js 多版本该用什么替代
用 nvm —— 它就是为这个场景写的，且和 phpenv 完全兼容共存。
安装方式（Linux/macOS）：
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
然后在 ~/.zshrc（或 ~/.bashrc）里确保这两行存在（顺序不重要，但必须都在 shell 启动时执行）：
export NVM_DIR="$HOME/.nvm" [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
验证：nvm --version 应输出版本号；node -v 此时应报 command not found（说明 nvm 尚未激活任何版本，这是正常状态）。
常用操作：
-
nvm install 18.20.2—— 下载并安装指定 LTS 版本 -
nvm use 18.20.2—— 当前 shell 切换过去 -
nvm alias default 18.20.2—— 新开终端自动加载该版本 -
nvm install --lts—— 安装最新 LTS（如 20.x）
phpenv 和 nvm 共存要注意什么
两者都靠 shell 函数劫持 PATH，只要初始化顺序合理，不会冲突。关键点：
- 不要把
nvm.sh的 source 放在phpenv init之后又包裹在eval里（某些旧教程这么干） - 避免在项目根目录同时放
.php-version和.nvmrc并期望自动联动 —— 它们互不识别，得靠额外脚本（如direnv）桥接 -
npm install -g安装的命令（如eslint、typescript）只对当前nvm use的 Node 版本生效；换版本后需重新npm install -g或用nvm install --reinstall-packages-from=18.20.2
如果你真需要“进目录自动切 PHP + Node”，direnv 是目前最稳的解法：它能读取多个环境文件，分别调用 phpenv local 和 nvm use，且失败时有清晰错误提示。
