VSCode调试Node.js超时主因是launch.json中program路径错误、node命令不可达或--inspect未启用；需验证node -v、用${workspaceFolder}写program、Web服务改用request:"attach"并指定port，TS项目须配准sourceMaps。
VSCode调试Node.js超时，90%不是网络或防火墙问题，而是launch.json里program路径错、node命令不可达，或--inspect根本没启用。
断点灰掉、F5后卡住几秒就报“timeout”？先查node和program
VSCode的Node调试器只是个“遥控器”，它调用你系统里的node命令启动进程。如果终端里node -v都报错，VSCode连遥控信号都发不出去。
- Mac/Linux：在终端执行
which node，没输出就说明PATH没配好；用nvm的话，必须从已加载nvm.sh的终端启动VSCode（比如在终端输code .） - Windows：确认安装Node时勾选了“Add to PATH”，或手动把
C:\Program Files\nodejs\加进系统环境变量 -
program字段必须是真实存在的JS文件，且路径以${workspaceFolder}开头——写成"src/index.js"或"./src/index.js"都会失败 - 如果项目入口是
index.ts，别直接填进去；要么先tsc编译，把program指向dist/index.js；要么换用type: "pwa-node"配合runtimeArgs: ["-r", "ts-node/register", "src/index.ts"]
request: "launch" vs request: "attach"：超时往往卡在launch上
Web服务类项目（Express/Koa/Nest）用request: "launch"极易超时：它要抢在端口被占前启动、要同步环境变量、还要等子进程fork完成。一旦某步慢半拍，VSCode就判定“连接超时”。
dmap-jsapi-skill
下载
DMap GL地图JSAPI（dmapgl）开发指南。用于编写、审查、调试 DMap 地图 API 代码，涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。
- 改用
request: "attach"：先在终端手动跑node --inspect-brk ./bin/www，看到Debugger listening on ws://...再点F5 -
launch.json里必须显式写"port": 9229（或你启动时指定的端口），不能依赖自动探测 - Windows下cmd有时连不上，换成PowerShell，或启动时加
--inspect=0.0.0.0:9229 - 别同时起两个
--inspect进程——第二个会因端口冲突直接失败，VSCode连尝试连接的机会都没有
TypeScript项目调试超时？sourceMaps配置不对也会拖慢初始化
TS项目如果sourceMaps没对齐，VSCode会在启动时反复扫描outFiles路径找map文件，卡住几秒甚至更久，最终触发超时。
- 确保
tsconfig.json里开了"sourceMap": true，且"inlineSourceMap": false -
launch.json中"sourceMaps": true必须开启，"outFiles"要精确匹配编译输出目录，比如"${workspaceFolder}/dist/**/*.js" - 如果用了Webpack/Babel，
"resolveSourceMapLocations"得设成["${workspaceFolder}/**"]，否则VSCode找不到map位置 - 构建命令没提前运行（比如
npm run build），dist/目录为空，调试器会干等然后超时
用nodemon热重载还超时？restart: true不是万能的
restart: true只在VSCode成功附加到一个进程后才生效。如果nodemon还没启动好、调试端口没打开，VSCode连第一次attach都失败，自然不会触发重启逻辑。
- package.json里
"debug": "nodemon --inspect-brk ./index.js"必须带--inspect-brk（不是--inspect），确保进程一启动就暂停，留出VSCode连接时间 -
launch.json用request: "attach"+"port": 9229+"restart": true，不要用runtimeExecutable硬调nodemon（Windows上常因.cmd扩展名失败） - 首次调试务必先在终端跑
npm run debug，等看到Debugger listening on ws://...再点F5——顺序错了，超时就是必然结果
真正容易被忽略的是：VSCode的超时判断不看代码执行，只看“调试协议握手”是否在默认时限内完成。哪怕你的index.js里只有一行console.log(1)，只要node命令不可达、program路径不存在、或--inspect没加对，它就会在连接阶段直接放弃。
