VSCode终端中node -v报command not found，根本原因是其启动时未加载shell配置文件（如~/.zshrc），导致PATH缺失；需设置terminal.integrated.shellArgs为["-l"]并彻底重启VSCode解决。
node命令在VSCode终端里跑不通？先查PATH继承问题
VSCode调试器调用的是系统node，不是自带运行时。终端里node -v报错，调试必挂——这不是插件或设置问题，是VSCode没加载你的shell初始化文件。
- macOS/Linux：检查
~/.zshrc或~/.bash_profile是否导出Node路径（如export PATH="/opt/homebrew/bin:$PATH"），改完后执行source ~/.zshrc，再从该终端启动VSCode（code .） - Windows：重装Node.js，务必勾选“Add to PATH”；或手动把
C:\Program Files\nodejs\加进系统环境变量 - VSCode必须彻底退出再重开——改了环境变量它不会自动刷新
验证方式：打开VSCode内置终端（Ctrl + `），执行node -v和npm -v，必须有输出。
launch.json中program字段写错，断点永远灰掉
program必须指向能被node直接执行的.js文件，不是文件夹、不是.ts、不是软链接、也不能是相对路径字面量。
Zenlink - Node SDK for ZenHeart
下载
ZenHeart zenlink 与 zenlink-mcp 为 OpenClaw，涵盖安装、MCP 注册、钩子接线、入站轮询及升级维护。
- 正确写法：
"program": "${workspaceFolder}/src/index.js" - 错误写法：
"program": "src/index.js"（缺${workspaceFolder}/，VSCode找不到） - 错误写法：
"program": "./src/index.js"（.在这里不解析，等同于字面字符串） - TypeScript项目：别指
src/index.ts，要么配preLaunchTask编译到dist/，然后指dist/index.js；要么用runtimeExecutable: "npx"+runtimeArgs: ["ts-node", "src/index.ts"] - ESM项目：确保
package.json里有"type": "module"，否则import会解析失败
用nodemon热重载调试，别直接改program
把program改成nodemon脚本会导致调试断连——VSCode会尝试直接执行nodemon，而不是让它启动带--inspect的Node进程。
- 正确做法：换用
runtimeExecutable+runtimeArgs - 本地安装：
npm install --save-dev nodemon - 配置项应为：
"runtimeExecutable": "${workspaceFolder}/node_modules/.bin/nodemon"，"runtimeArgs": ["--inspect-brk", "${workspaceFolder}/index.js"] - 全局安装可写
"runtimeExecutable": "nodemon"，但需确保PATH可访问 - 注意：
--inspect-brk由runtimeArgs传入，不要在命令行里重复加--inspect，否则端口冲突
断点变空心、hover看不到变量？先盯住source map和--inspect模式
断点灰掉、调用栈显示eval、路径乱码——调试器压根没定位到原始代码位置。
- Node版本必须≥14（旧版不支持现代
--inspect协议） - TypeScript：确认
tsconfig.json开启"sourceMap": true和"inlineSources": true，且编译后.js.map和.js在同一目录 - Webpack/Babel：
devtool设为"source-map"或"inline-source-map"，禁用"eval"类型 -
.js.map里的sources字段必须是相对路径（如../src/index.ts），绝对路径容易404 - attach模式调试已运行进程时，
port必须严格匹配命令行中--inspect=9230指定的端口，默认9229但极易冲突，建议显式指定
最常被忽略的其实是package.json里漏写"type": "module"，或者tsconfig.json里sourceMap开关开着但outDir路径和program指向不一致——这两处一错，断点就永远停不住。
