能跑node -v且F5断点调试成功才算真正搭好；需先在系统终端验证which/where node路径，彻底退出VSCode进程后重启，再于内置终端执行node -v和npm -v确认可用，launch.json用${file}起步，勿装过时Node插件。

能跑 node -v 且 VSCode 里按 F5 能断点调试，才算真正搭好；其余插件、格式化、TypeScript 都是后续优化项，不是启动前提。

验证 node 和 npm 是否真被系统识别

很多人在 VSCode 内置终端里敲 node -v 报错，却以为是编辑器问题——其实根本没进系统 PATH。

• 关掉所有 VSCode 窗口，**彻底退出进程**（macOS 在 Dock 右键选「退出」，Windows 在任务管理器确认 Code.exe 已结束）
• 打开系统终端（不是 VSCode 里的），执行 where node（Windows）或 which node（macOS/Linux），确认路径指向你安装的 Node.js（如 C:\Program Files\nodejs\node.exe 或 /usr/local/bin/node）
• 再启动 VSCode，按 Ctrl+` 打开内置终端，立刻执行 node -v 和 npm -v —— 这次的结果才代表 VSCode 能真正调用到
• Windows 用户若装在中文路径（如 D:\我的软件\nodejs）或含空格路径下，npm 可能静默失败，重装到纯英文无空格路径（如 C:\nodejs）即可

launch.json 配置必须匹配你的运行方式

VSCode 自动生成的 launch.json 默认只适合单文件调试，一上手就改 npm start 或 nodemon 就会卡住。

Zenlink - Node SDK for ZenHeart

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

下载

• 想调试 npm start？把 "program" 改成 "npm"，加 "args": ["start"]，并设 "console": "integratedTerminal"，否则看不到 npm 输出
• 用 nodemon 热重载？别直接在 launch.json 里写 nodemon index.js —— VSCode 调试器不支持进程热替换，必须用 attach 模式：
  先在终端运行 nodemon --inspect-brk index.js，再在 launch.json 中配 "type": "node"、"request": "attach"、"port": 9229
• 默认生成的 "program": "${file}" 是安全起点，先用它跑通 console.log('ok')，再动配置

别装“Node.js 插件”来凑数

Node.js Extension Pack、Debugger for Node.js 这类插件已过时，VSCode 自带 Node.js 调试支持，装了反而可能冲突。

• 确认 node -v 成功后，新建 index.js，写一行 console.log('ok');
• 按 Ctrl+Shift+P（macOS 是 Cmd+Shift+P），输入 Debug: Open Configuration，选 Node.js → Current File
• VSCode 会自动生成 .vscode/launch.json，此时在行号左侧单击设断点，按 F5 即可启动 —— 若提示 Cannot find runtime 'node'，一定是第一步环境没配好，不是 launch.json 的问题
• 扩展市场搜 “Node.js” 安装的插件，只提供语法高亮、代码片段等辅助功能，**不包含 node 运行时本身**

最易被忽略的点：VSCode 启动时读取的是它启动那一刻的系统环境变量；哪怕你刚在终端里改完 PATH，不重启 VSCode，内置终端依然看不到新配置。这点和浏览器缓存一个道理——不是 bug，是机制。