配好VSCode开发环境需满足四点：终端能运行node/npm、F5调试正常、脚本能读取.env、可调用node_modules/.bin工具；先验证系统终端中node -v/npm -v是否成功，PATH配置错误是主因；避免使用Code Runner执行运维脚本，应直接在VSCode内置终端运行并确保dotenv加载。
能直接在 VSCode 终端里跑 node、用 F5 调试脚本、且脚本能读取本地 .env 和调用 node_modules/.bin 里的工具（比如 cross-env、ts-node），才算配好了——不是装了插件就完事。
验证 node 和 npm 是否真可用
很多人卡在这一步，却以为是 VSCode 设置问题。关键不是“VSCode 能不能运行”，而是“系统终端能不能识别 node”。
- 打开系统终端（不是 VSCode 内置终端），执行：
node -v和npm -v - 如果报错
'node' 不是内部或外部命令，说明 PATH 没生效：Windows 用户检查安装时是否勾选Add to PATH；macOS/Linux 用户若用nvm，确认source ~/.nvm/nvm.sh已写入~/.zshrc或~/.bash_profile - 路径含空格或中文（如
C:Program Files odejs或/Users/张三/nodejs）会导致npm静默失败，必须重装到干净路径 - 改完环境变量后，必须完全退出 VSCode 再重启，否则内置终端仍继承旧 PATH
别用 Code Runner 执行运维脚本
Code Runner 插件默认用全局 node 执行，不加载项目级 package.json 的 "type": "module"、不注入 .env、也不走 node_modules/.bin，运维脚本一涉及 import、dotenv 或本地 CLI 工具就会崩。
Zenlink - Node SDK for ZenHeart
下载
ZenHeart zenlink 与 zenlink-mcp 为 OpenClaw，涵盖安装、MCP 注册、钩子接线、入站轮询及升级维护。
- 直接用 VSCode 内置终端（
Ctrl+`）执行：node scripts/deploy.js或npx ts-node scripts/cleanup.ts - 若脚本依赖
process.env，确保已用dotenv加载，或在终端里先source .env（Linux/macOS）或set /p _=<.env>（Windows cmd）</.env> - 想一键运行，写进
package.json："scripts": { "ops:deploy": "node scripts/deploy.js" }，然后终端里npm run ops:deploy
调试脚本必须显式指定 runtimeExecutable
运维脚本常需精确控制 Node 版本（比如要匹配生产环境的 18.x），而 VSCode 默认按 PATH 找 node，可能和你 node -v 看到的不是同一个。
- 在项目根目录建
.vscode/launch.json，内容至少包含：{ "version": "0.2.0", "configurations": [{ "type": "node", "request": "launch", "name": "Debug Ops Script", "runtimeExecutable": "/usr/local/bin/node", // macOS/Linux // "runtimeExecutable": "C:\dev\nodejs\node.exe", // Windows 绝对路径 "program": "${workspaceFolder}/scripts/deploy.js", "console": "integratedTerminal" }] } - 加一行
console.log(process.execPath)在脚本开头，对比输出路径是否与runtimeExecutable一致 - 不要依赖
Node.js Extension Pack—— VSCode 自带 Node 调试支持，装了反而可能冲突
tasks.json 跑自动化任务要补全 env 和 shell
VSCode 的 tasks.json 默认隔离环境：不继承 shell PATH、不加载 .env、也不自动用 node_modules/.bin 下的二进制，直接写 npm run deploy 很大概率报 command not found。
- 用
npx --no-install替代全局命令："command": "npx --no-install cross-env NODE_ENV=prod node scripts/deploy.js" - 显式声明 shell 路径：
"shell": { "executable": "/bin/zsh", "args": ["-c"] }（macOS/Linux）或"shell": { "executable": "cmd.exe", "args": ["/c"] }（Windows） - 手动注入环境变量：
"env": { "API_TOKEN": "xxx", "DB_HOST": "localhost" }，别指望dotenv自动生效 - 文件必须放在
./.vscode/tasks.json，且每个 task 至少有"label"和"type": "shell"，否则 Ctrl+Shift+P →Tasks: Run Task里看不到
真正难的不是配置本身，而是所有环节都得对齐：终端里的 node、调试器用的 node、tasks.json 调的 node、以及脚本里 require 的模块路径，四者稍有偏差，运维脚本就可能在本地跑通、CI 失败，或调试时断点失效。
