根本原因是VSCode启动时未加载shell初始化文件（如~/.zshrc），导致PATH未继承；macOS/Linux需从终端执行code --no-sandbox .启动，Windows需在系统环境变量Path中确认C:\Program Files\nodejs\路径准确无误。
VSCode终端里node -v报错，根本不是配置问题
VSCode启动时压根不读~/.zshrc或~/.bash_profile，所以你写在里面的export PATH=...对它完全无效。macOS/Linux下从Dock、Spotlight或桌面图标启动VSCode，进程不经过shell登录流程；Windows则只认系统级Path变量。
验证方法很简单：打开VSCode内置终端（Ctrl + `），直接输node -v——没输出就停在这步，别碰launch.json。
- macOS/Linux：改完
~/.zshrc后，必须彻底退出所有VSCode窗口（包括后台进程），再从终端执行code --no-sandbox .启动 - Windows：进「系统属性 → 高级 → 环境变量」，在「系统变量」的
Path里确认存在且拼写准确的C:\Program Files\nodejs\（注意斜杠方向、无多余空格）
launch.json里写了runtimeExecutable，反而让调试器找不到node
runtimeExecutable字段一旦写死路径，就完全绕过系统PATH，也不管你用的是nvm还是fnm。即使node -v在终端和VSCode终端里都能跑，调试器仍可能报Cannot find runtime 'node'。
如果项目根目录下有.vscode/launch.json，检查configurations里是否含"runtimeExecutable": "/xxx/node"；有就删掉这行，让调试器走默认查找逻辑。
ZenHeart zenlink 与 zenlink-mcp 为 OpenClaw，涵盖安装、MCP 注册、钩子接线、入站轮询及升级维护。
- 若必须指定（比如多版本共存），路径得写绝对路径，不能用
~（/Users/you/.nvm/versions/node/v18.17.0/bin/node可以，~/...不行） - 用
volta或fnm的用户，别依赖PATH切换，显式写死runtimeExecutable是唯一稳妥方案
settings.json里配env.linux根本不管用
.vscode/settings.json里的配置只影响编辑器行为（比如格式化、缩进），对终端启动时的PATH或调试器的运行时查找路径毫无作用。所谓“在VSCode里配环境变量”，本质是让它能继承你shell已有的环境，不是靠编辑器自己“加”进去。
尤其注意："terminal.integrated.env.linux": { "PATH": "" }这种写法只对新打开的终端生效，且极易覆盖原有PATH导致npm、git等命令丢失。
- 真正要改环境变量，只做两件事：确保shell初始化文件（
~/.zshrc）正确导出PATH；确保VSCode进程本身是从该shell启动的 - 工作区设置唯一有用的地方是
code-runner.executor这类执行器路径，跟Node运行时无关
program字段写${file}比写死app.js更可靠
VSCode调试时自动生成的launch.json默认是"program": "${workspaceFolder}/app.js"，这会导致你换一个文件（比如server.js）调试时F5直接失败。调试前也不会自动保存未保存的文件，务必按Ctrl+S（Windows/Linux）或Cmd+S（macOS）。
- 如果项目入口固定（如
index.js），可设为"program": "${workspaceFolder}/index.js" - 日常开发中更推荐
"program": "${file}"，这样无论当前打开哪个JS文件，F5都直接运行它 - 搭配
"console": "integratedTerminal"，能实时看到console.log和错误堆栈，比内建调试控制台更直观
launch.json写得不够全，而是VSCode根本没拿到你shell里已经生效的PATH——它连node命令在哪都不知道，后面所有配置都是白搭。 
