VSCode怎么配置launch.json调试文件

VSCode调试启动失败的罪魁祸首，其实就那么几个——launch.json里configurations是空的、program路径指向了空气，或者是type字段对应的调试插件根本没装上。这本来不是什么复杂的配置问题，但偏偏这几步绊倒了多数人。我们先说最核心的几个关键点：configurations绝对不能空着，program必须是${workspaceFolder}下面真实存在的可执行文件路径，而且type必须和已经装的调试器严格匹配。

说实话，VSCode调试启动失败，九成的情况都是因为program路径写错了、configurations字段是空的，或者type对应的调试插件干脆没装。配置本身真不算难，但只要这几处关键字段没对上，一切免谈。

launch.json 里 configurations 不能为空数组

有时候你点了“开始调试”，VSCode却毫无反应，或者直接弹窗报“无法找到有效的启动配置”。这种情况，十有八九是configurations字段压根儿没写，或者写成了空数组[]。

• 必须确认.vscode/launch.json文件存在，而且顶层结构是"configurations": [ ... ]
• 哪怕只想调试一个最简单的Node.js脚本，也得提供"type"、"request"、"name"这三个字段
• 从别处复制配置时，如果直接把整个configurations块删掉了，只留下{}或空文件，那配置就无效了

program 字段必须指向可执行入口，且路径相对于工作区根目录

program这个字段，它不是指向“当前打开的文件”，也不是.vscode/目录下的相对路径。它必须是一个相对于项目根目录的、真实存在的可执行文件路径。而项目根目录，就是${workspaceFolder}这个变量所代表的位置。

• 对于Node.js项目，通常写成"${workspaceFolder}/dist/index.js"（编译后的版本），而不是"./src/index.ts"——TypeScript源码没法直接运行
• 如果想在TypeScript项目中直接调试.ts文件，那就得配置"type": "pwa-node"并加上"runtimeExecutable": "./node_modules/.bin/ts-node"
• 绝对路径（比如"C:\project\index.js"）千万不要用，换个机器就崩。一律用${workspaceFolder}变量
• Windows系统下，路径分隔符统一用正斜杠/，不要用反斜杠

launch 和 attach 模式选错，调试行为完全不对

这两者的本质区别在于：谁先启动进程。launch是让VSCode自己创建新进程并注入调试器；attach则是连接到已经运行起来的进程。选错了，要么连不上，要么断点根本不生效。

• 脚本类型文件（如index.js、main.py）应该用"request": "launch"，当然也得提供program
• 如果是Web服务（Express、Fastify）、后台常驻进程或者Electron主进程，优先用"request": "attach"。这样每次改代码都不需要重启整个调试会话
• 在attach模式下，目标进程启动时必须加上--inspect-brk参数，而且port字段必须与launch.json中的"port": 9229完全一致
• 在Windows上用cmd启动的node进程，有时候attach会不稳定。可以换成PowerShell，或者显式指定--inspect=0.0.0.0:9229

TypeScript 断点不命中？sourceMaps 和 outFiles 得一起配

断点在.ts文件上设置后却不停下来，这不是VSCode本身的问题，而是sourcemap没有被正确识别或加载。

• 编译时必须在tsconfig.json中开启"sourceMap": true，同时关掉inlineSourceMap
• 在launch.json中显式加上"sourceMaps": true和"outFiles": ["${workspaceFolder}/dist/**/*.js"]
• 检查一下dist/index.js.map这个文件是否真实存在，而且它里面的sources字段指向的是你workspace里的.ts路径（例如["../src/index.ts"]）
• 在大型单体项目中，如果map里存的是绝对路径，可能需要额外配置"resolveSourceMapLocations": ["${workspaceFolder}/**", "!**/node_modules/**"]

有一个容易被忽略的点，其实是cwd和env这两个字段。比如Python的导入失败、Node.js找不到.env文件、读取文件时路径出错，往往不是program本身有问题，而是cwd没有设置成${workspaceFolder}，或者PYTHONPATH、NODE_ENV这些环境变量没有通过env字段正常注入进去。