vscode本身不配置node+express环境，仅提供编辑、运行和调试能力；真正环境由终端可执行的node+npm+express代码构成，需验证node -v/npm -v输出版本号、存在package.json、launch.json中program与runtimeexecutable严格匹配启动命令。
VSCode 本身不“配置” Node + Express 环境，它只负责编辑、运行和调试；真正起作用的是你终端里能跑通的那套 node + npm + express 代码。只要 node app.js 在 VSCode 内置终端里能输出 Server running on http://localhost:3000，环境就算通了——卡点基本都出在路径、package.json 缺失或调试配置错位上。
确认 node 和 npm 能在 VSCode 终端里直接调用
不是“装过就行”，而是终端启动时必须加载正确的 Node 版本：
- 在 VSCode 内置终端（
Ctrl+`）中执行node -v和npm -v，必须有版本号输出；若报command not found，说明 shell 环境没加载 Node —— macOS/Linux 用户检查~/.zshrc或~/.bashrc是否 source 了 nvm/fnm；Windows 用户建议统一用 Windows Terminal + PowerShell，并在 VSCode 设置里把terminal.integrated.defaultProfile.windows设为同一 shell - 别信“系统弹窗说安装成功”，要亲手敲命令验证；某些一键安装包（尤其 Windows 上旧版）会把
node.exe放进子目录但没加进 PATH，导致 VSCode 终端找不到
项目必须有 package.json，否则 express 根本 require 不进来
npm install express 不等于“装好了 Express”，它只在有 package.json 的前提下才往当前目录的 node_modules 里装。没这个文件，npm 就可能装到全局或直接报错：
Zenlink - Node SDK for ZenHeart
下载
ZenHeart zenlink 与 zenlink-mcp 为 OpenClaw，涵盖安装、MCP 注册、钩子接线、入站轮询及升级维护。
- 先执行
npm init -y，生成最简package.json；这一步不能跳，哪怕只是写个console.log('hi') - 再执行
npm install express；此时node_modules/express才真实存在，require('express')才不会抛Cannot find module 'express' - 如果已写好
app.js却报错，先ls node_modules看有没有express目录；没有就说明package.json缺失或npm install没在正确目录下执行
调试时 launch.json 的 program 和 runtimeExecutable 必须严格匹配启动方式
VSCode 调试器不理解“Express”，它只认你终端里敲的那条命令。用 nodemon 却在 launch.json 里写 "runtimeExecutable": "node"，断点永远不触发：
- 如果用
npm run dev启动（脚本值为nodemon --inspect-brk=9229 app.js），launch.json里就得设"runtimeExecutable": "npm"，"args": ["run", "dev"]，且"console": "integratedTerminal" - 如果直接用
nodemon app.js，先查路径：which nodemon（macOS/Linux）或where nodemon（Windows），然后填进runtimeExecutable；别留空，也别填node -
program字段必须是入口文件的相对路径（如"./app.js"），不能写绝对路径，也不能漏掉./
静态资源 404 或路由断点不生效？先看请求有没有真发到服务端
浏览器地址栏输 http://localhost:3000/ 没反应，不一定是代码问题，很可能是服务根本没起来，或者端口被占：
- 启动后立刻在终端里看日志：有没有
Server running on http://localhost:3000这类输出？没有就说明app.listen()没执行到，检查前面是否有同步错误（比如require失败被吞了） - 用
curl http://localhost:3000/或telnet localhost 3000测试端口连通性；如果连接拒绝，说明进程没监听，或监听了别的端口（检查app.listen(3000)的参数是否被覆盖） - 断点打在
app.get('/', ...)却不触发？先确认浏览器请求 URL 和路由路径完全一致（注意 trailing slash、大小写），再看 Express 是否用了app.use(express.static(...))把请求提前拦截了
最常被忽略的其实是 package.json 存在与否，以及 VSCode 终端是否真的加载了你认为的那个 Node 版本——这两处一错，后面所有配置都白搭。
