phpenv 不支持 Node.js 管理，需用 nvm 单独管理 Node 版本；二者 PATH 必须隔离配置，PHP-FPM 中调用 Node 需显式指定路径或在 www.conf 中设置 env[PATH]。
phpenv 本身不管理 Node.js 环境 —— 它只负责 PHP 版本切换。想用 phpenv 搭全栈环境（PHP + Node.js），得明确分工：PHP 归 phpenv，Node.js 得另配，不能混用。
phpenv 和 Node.js 是两套独立系统
很多人搜“phpenv nodejs”是误以为 phpenv 能像管理 PHP 那样切换 Node 版本，但事实是：phpenv 的代码里没有 Node 相关逻辑，它的插件生态（比如 php-build）也只编译 PHP。强行往 phpenv 里塞 Node 配置，只会导致路径冲突、which node 找不到、或 npm 报 ERR! Cannot find module 'npmlog' 这类错误。
Node.js 必须单独安装并配置 PATH
Windows 用户直接用官方 .msi 安装包最稳妥；macOS/Linux 推荐用 nvm（不是 phpenv 的替代品，而是专为 Node 设计的版本管理器）。关键点：
-
nvm安装后，node和npm二进制文件由它动态注入$PATH，和phpenv的shims机制互不干扰 - 别把 Node 安装到
~/.phpenv/versions/下——phpenv不识别该路径，也不会帮你软链node - 验证是否共存成功：分别运行
php -v和node -v，两个命令都应立即返回版本号，且which php指向~/.phpenv/shims/php，which node指向~/.nvm/versions/node/...
常见 PATH 冲突场景与修复
当 node -v 报错或返回旧版本，大概率是 PATH 顺序错了。典型表现：
-
which node返回/usr/local/bin/node（系统自带或 brew 装的老版本），而不是nvm的路径 -
phpenv初始化脚本（eval "$(phpenv init -)"）写在~/.zshrc末尾，但nvm的初始化（export NVM_DIR=...; [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"）写在了前面 → 导致nvm的node被phpenv的 shims 覆盖 - Windows 上同时装了 Node 官方版和 WSL 里的 Node，PowerShell 里
node走的是 Windows 版，而 WSL 终端里走的是 Linux 版，但项目里调用的exec('node script.js')可能意外触发另一套环境
全栈项目启动时的执行环境陷阱
PHP 启动 Node 子进程（比如用 exec("node build.js") 或 Laravel Mix）时，PHP 进程继承的是 Web 服务器（如 Nginx + PHP-FPM）的环境变量，而非你终端里的 $PATH。这意味着：
立即学习“PHP免费学习笔记（深入）”；
- 即使你在 shell 里
node -v正常，PHP 里exec('which node')可能返回空或报错 - 解决方案不是改
phpenv，而是显式指定 Node 路径：exec('/home/yourname/.nvm/versions/node/v20.12.0/bin/node build.js') - 更可持续的做法：在 PHP-FPM 的
www.conf里加env[PATH] = /home/yourname/.nvm/versions/node/v20.12.0/bin:/usr/local/bin:/usr/bin:/bin
phpenv 和 Node.js 共存本身不难，难的是环境变量作用域的边界意识——终端、Web 服务、子进程，三者看到的 PATH 可能完全不同。别指望一个工具管所有 runtime，分清责任边界比强行统一更重要。 
