vscode 依赖系统安装的 node.js 且需正确配置环境变量，否则终端无法识别 node/npm；务必关闭并重启 vscode 以继承系统 path，调试时优先用 "${file}" 动态路径，避免相对路径，并确保全局工具路径已加入系统环境变量。

VSCode 本身不带 Node.js，装完插件也跑不了 node 命令——必须先在系统层面装好 Node.js，并确保终端能识别 node 和 npm，VSCode 才可能调试、运行、安装依赖。

node -v 在系统终端能跑，但在 VSCode 终端报 command not found

这是新手最常卡住的点，根本不是 VSCode 的问题，而是环境变量没继承过来。

• 关掉所有 VSCode 窗口（macOS 在 Dock 右键选「退出」，Windows 在任务管理器里确认 Code.exe 已结束）
• 打开系统终端（不是 VSCode 内置终端），执行 which node（macOS/Linux）或 where node（Windows），确认输出路径是你手动安装的目录（比如 /usr/local/bin/node 或 C:\Program Files\nodejs\node.exe）
• 如果路径正确，再启动 VSCode，按 Ctrl+` 打开内置终端，立刻执行 node -v —— 这次的结果才代表它真正可用
• Windows 用户若重装过 Node.js 却仍不行，检查安装时是否勾选了 Add to PATH；没勾就手动把 C:\Program Files\nodejs 加进系统环境变量 Path

launch.json 中 program 字段写成绝对路径或硬编码文件名

VSCode 自动生成的调试配置容易误导人，"program": "${workspaceFolder}/app.js" 这种写法会让你换文件调试时直接失败。

Zenlink - Node SDK for ZenHeart

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

下载

• 日常单文件调试，用 "program": "${file}" 最稳妥，F5 总是运行当前打开的 JS 文件
• 项目有固定入口（如 index.js 或 server.js），可设为 "program": "${workspaceFolder}/index.js"，但别写成 "./index.js" 或 "index.js" —— 调试器不解析相对路径
• 改完 launch.json 后，务必先保存当前 JS 文件（Ctrl+S），VSCode 不会自动保存未保存的文件就启动调试

npm install 全局工具（如 nodemon）后，VSCode 终端里提示 command not found

不是 npm 没装上，而是 VSCode 终端没读取你 shell 配置里新增的全局 bin 路径。

• 先确认全局路径是否生效：npm config get prefix 应输出你设的路径（如 D:\npm-global），且该路径已加进系统 PATH
• 如果系统终端能用 nodemon，但 VSCode 里不行，大概率是 shell 配置（如 ~/.zshrc）没被加载 —— 直接在 VSCode 终端里执行 source ~/.zshrc（macOS/Linux）或重启 VSCode 更快
• 别用 Code Runner 插件右键 Run Code 来跑 Node 脚本，它不走 package.json 或 launch.json，容易绕过环境配置，出错时难以定位

最容易被忽略的其实是“VSCode 终端是否真的等于你的系统终端”——它不是子进程，而是复用 shell 环境；一旦环境变量没加载全，node、npm、nodemon 全都会静默失效。验证这一步，比装十个插件都关键。