VSCode终端与系统终端Node版本不一致？Node环境多版本配置-VSCode-PHP中文网

vscode终端node -v与系统不一致的根本原因是其默认以非login shell启动，不加载~/.zsh_profile等仅login shell读取的nvm初始化文件；需将nvm配置移至~/.zshrc或配置terminal.integrated.profiles.zsh的args为["-l"]并彻底重启vscode。

vscode终端与系统终端node版本不一致？node环境多版本配置

VSCode 终端里 node -v 和系统终端不一致，不是 VSCode 故意“不认”你装的 nvm，而是它启动时没加载你的 shell 初始化逻辑——根本原因在于 shell 启动模式和配置文件读取路径错位。

为什么 VSCode 终端不继承 `nvm` 环境？

VSCode 集成终端默认以非 login shell 启动（比如 zsh 不带 -l 参数），因此只读 ~/.zshrc，但很多用户把 nvm 初始化代码（export NVM_DIR=... && [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"）写在了 ~/.zsh_profile 或 ~/.bash_profile 里——这些文件仅被 login shell 加载。

macOS/Linux：检查 nvm 是否可用：which nvm 返回空，说明初始化未生效
确认初始化代码所在文件：cat ~/.zshrc | grep nvm 或 cat ~/.zsh_profile | grep nvm
若代码在 ~/.zsh_profile，而 VSCode 启动的是非 login shell，则完全不会执行
Windows 用户用 nvm-windows 时，必须确保 nvm.ps1 在 PowerShell 的 $PROFILE 中导入，且 VSCode 终端 profile 设为 PowerShell

`terminal.integrated.inheritEnv` 设为 true 就够了吗？

不够。设 terminal.integrated.inheritEnv 为 true 只让 VSCode 继承父进程环境变量，但它启动 GUI 时本身没加载过 nvm，所以 NVM_DIR、NVM_BIN 这些变量根本不存在——继承了个空壳。

Zenlink - Node SDK for ZenHeart

ZenHeart zenlink 与 zenlink-mcp 为 OpenClaw，涵盖安装、MCP 注册、钩子接线、入站轮询及升级维护。

下载

真正起效的前提是：VSCode 启动前，终端已加载 nvm；推荐从命令行执行 code . 打开项目
macOS 下若 Dock 点开 VSCode，它默认读 ~/.bash_profile（即使你用 zsh），导致 nvm 不生效
修改 settings.json 强制 login shell 更可靠："terminal.integrated.profiles.zsh": { "path": "zsh", "args": ["-l"] }
改完后必须完全退出 VSCode（macOS：Dock 右键 → Quit；Windows：任务管理器结束所有 Code.exe），否则环境快照不刷新

如何让每个新开终端自动用项目指定 Node 版本？

靠 .nvmrc + login shell 启动 + nvm auto-use 机制，而不是手动 nvm use。

在项目根目录放 .nvmrc，内容只有一行：18.18.2（不要加 v 前缀，nvm 不识别 v18.18.2）
确保 shell 初始化脚本末尾有：source $NVM_DIR/nvm.sh && nvm use --silent（--silent 避免每次启动都打印提示）
VSCode 新开终端会触发 login shell → 读 ~/.zsh_profile → source nvm.sh → 自动执行 nvm use → 读 .nvmrc
验证：新开终端后立即运行 node -v 和 which node，输出应指向 ~/.nvm/versions/node/v18.18.2/bin/node
别依赖插件如 vsc-nvm：它只对新终端生效，已打开的终端不会自动 reload，且部分版本与最新 nvm 冲突

`launch.json` 里 `runtimeExecutable` 为啥还是用错版本？

因为 ${env:NVM_BIN}/node 展开失败——NVM_BIN 根本没被 VSCode 加载，或者你没重启。

先在 VSCode 终端里运行 echo $NVM_BIN，有输出才说明环境就绪；为空就别配 runtimeExecutable
runtimeExecutable 只影响调试器主进程，不影响插件主机（Extension Host）或 ESLint 等后台服务
如果插件报 Cannot find module './build/Release/xxx.node'，不是这里的问题，而是 VS Code 内置 Electron 的 Node ABI（process.versions.napi）和你本地 node 不匹配
硬编码路径如 "runtimeExecutable": "/Users/x/.nvm/versions/node/v18.18.2/bin/node" 会导致协作崩溃，绝对避免