vscode终端报“command not found”是因未继承系统path或node.js未正确配置path：windows需重装时勾选add to path或手动添加c:\program files\nodejs；macos/linux需将which node路径写入~/.zshrc并source，再彻底重启vscode后执行node -v验证。

VSCode 本身不运行 Node.js，它只是编辑器；真正起作用的是你本地装好的 node 和 npm，且必须能在终端里直接调用——这是所有后续操作的前提。

node -v 在 VSCode 终端里报 command not found 怎么办

这不是 VSCode 的问题，而是环境变量没继承或根本没配好。

• Windows 用户重装 Node.js 时，务必勾选 Add Node.js to PATH；若已装完，手动把 C:\Program Files\nodejs（或你实际的安装路径）加进系统 Path 变量
• macOS/Linux 用户用 brew install node 安装后，检查 which node 输出是否在 ~/.zshrc 或 ~/.bash_profile 的 PATH 里；没加就补上 export PATH="$(brew --prefix)/bin:$PATH" 并执行 source ~/.zshrc
• VSCode 内置终端可能缓存旧环境：关掉所有窗口，重新用 code . 打开项目文件夹再试
• 验证方式：在 VSCode 终端里执行 node -v 和 npm -v，两个都返回版本号才算过关

launch.json 中 program 字段写什么才不会调试失败

VSCode 自动生成的 launch.json 默认是 "program": "${workspaceFolder}/app.js"，但你项目入口可能是 index.js、server.js 或其他名字——写错就直接报错“Cannot find module”。

Zenlink - Node SDK for ZenHeart

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

下载

• 最稳妥的写法是 "program": "${file}"：调试当前打开的 JS 文件，适合单文件快速验证
• 如果项目有固定入口（比如 index.js），明确写成 "program": "${workspaceFolder}/index.js"
• 别用相对路径如 "./index.js"，VSCode 调试器不认这种写法
• 调试前务必保存文件（Ctrl+S / Cmd+S），VSCode 默认不自动保存未修改文件

npm install 太慢或全局工具（如 nodemon）找不到命令

国内直连 npm 官方源基本不可用，且默认全局路径常在 C 盘，容易爆满。

• 换镜像：执行 npm config set registry https://registry.npmmirror.com
• 改全局路径（以 D 盘为例）：npm config set prefix "D:\npm-global"，然后把该路径加进系统 PATH
• 验证配置：npm config get registry 和 npm config get prefix 应输出对应值
• 重装全局工具：npm install -g nodemon，之后就能在任意目录用 nodemon index.js
• 注意：VSCode 终端可能没读取 shell 配置，如果系统终端能用 nodemon，VSCode 里却报错，重启 VSCode 或手动在终端里执行 source ~/.zshrc

最容易被忽略的其实是环境变量的“可见性”——不是装了 Node.js 就万事大吉，而是要确保 VSCode 启动时能拿到和你系统终端完全一致的 PATH 和 npm 配置。这点卡住的人最多，但解决起来其实就两步：确认终端里 node 和 npm 可用，再让 VSCode 终端同步这个状态。