VSCode调试Node.js断点不生效主因是node未启用调试模式、launch.json配置错误或断点未落在实际执行代码上；需验证--inspect参数、program路径、sourceMaps及端口一致性。
VSCode 断点调试 Node.js 不需要额外插件，只要 node 命令可用、launch.json 配置正确、断点落在实际执行的代码行上，就能立刻生效。关键不是“能不能”，而是“哪一步卡住了”。
断点不触发？先确认 node 进程是否真在调试模式运行
断点没反应，90% 是因为 VSCode 没连上正在跑的 Node 进程，或者进程根本没启用调试协议。
- 用
node --inspect app.js启动时，终端会输出类似Debugger listening on ws://127.0.0.1:9229/...的提示 —— 没这行，说明没进调试模式 - 如果用了
nodemon，必须加--inspect参数：nodemon --inspect app.js，否则它默认不透传调试参数 -
launch.json里"request": "attach"配置要求进程已启动；而"request": "launch"是 VSCode 自己拉起进程，二者不能混用 - 端口被占用（比如另一个
node --inspect进程还在跑）会导致连接失败，可换端口：node --inspect=9230 app.js，并同步改launch.json中的"port"
launch.json 怎么写才不踩坑
配置文件写错一个字段，断点就变空心圆，变量面板里啥都看不到。最简可用配置只有三个必填项。
Comprehensive Three.js 3D graphics reference
下载
详细的 Three.js 3D 图形参考，涵盖场景设置、相机、几何体、材质、光照、动画、控制器、加载器、数学工具和调试。
-
"type": "node"：必须是小写node，不是Node或NodeJS -
"request": "launch"或"request": "attach"：二选一，别漏引号，也别拼错 -
"program": "${workspaceFolder}/app.js"：路径必须存在且为 JS 文件，${file}只适用于当前打开的单文件调试 - 调试 TypeScript 或打包后代码？必须加
"sourceMaps": true，且确保生成了.map文件；否则断点绑不到源码行 - 避免跳过业务代码：
"skipFiles"默认含["<node_internals>/**"]</node_internals>，但别误加["/**"]，否则所有文件都被跳过
变量看不全？重点检查作用域和异步时机
断点停下了，VARIABLES 面板却只显示 this、arguments，或某些变量标着 <not available></not>，这不是 VSCode 问题，是 JavaScript 执行模型决定的。
- 函数参数和局部变量只在对应函数执行帧中可见；跳出函数后，它们自动消失 —— 这是正常行为，不是 bug
- 异步回调里的变量（如
setTimeout、Promise.then）需在回调内部设断点才能看到，外层断点停不住它们 - 箭头函数没有自己的
arguments，也不绑定this，VARIABLES 面板里自然不列出来 - 想查某个表达式值？别只靠悬停，直接在 WATCH 面板里加
items.filter(x => x.id === 123)这类表达式，实时求值更可靠
调试 HTTP 服务时请求没进断点？注意浏览器发了两次请求
用 http.createServer 或 Express 写的服务，断点设在请求处理函数里，但访问 localhost:3000 后断点没触发 —— 很可能是因为浏览器顺带请求了 /favicon.ico，而你的断点只在主路由里。
- 在 handler 开头加
console.log(req.url)，确认请求路径是否匹配断点位置 - 把断点设在
req对象刚进来的地方，比如server.on('request', (req, res) => { debugger; ... })，能捕获所有请求 - 用
curl http://localhost:3000替代浏览器访问，排除 favicon、预加载等干扰请求 - Express 用户注意：
app.get('/api/users', ...)的断点只对GET /api/users生效，POST或其他路径不会停
最常被忽略的是：断点设在未执行的分支里（比如 if (false) { /* breakpoint here */ }），或者文件没保存就点调试 —— VSCode 调试器读的是磁盘文件，不是编辑器缓存。每次改完代码，务必按 Ctrl+S 保存再调试。
