VSCode调试能力依赖launch.json精准配置，需匹配项目类型、环境与启动方式；其核心是configurations数组，每个配置必含name、type、request字段，并按Node.js、Python、前端等场景设置关键参数。
vscode 的调试能力很强大，关键在于 launch.json 配置是否精准。它不是“写完就能跑”，而是要和你的项目类型、运行环境、启动方式严格匹配——配错一行，就可能无法断点、找不到源码、甚至根本起不来调试器。
理解 launch.json 的核心结构
launch.json 是 VSCode 调试会话的“说明书”，存放在工作区根目录下的 .vscode/launch.json 中。它必须包含一个 configurations 数组，每个对象代表一种调试配置（比如“启动 Node.js 服务”或“附加到已运行进程”）。
每个配置至少要有三个字段：
- name：调试配置的显示名，在 VSCode 左侧调试图标下拉菜单中可见；
-
type：指定调试器类型，如
node、python、chrome、pwa-node等，决定使用哪个 Debugger Extension； -
request：取值为
launch（启动新进程调试）或attach（连接已有进程），这是行为分水岭。
常见语言/场景的关键配置项
不同语言依赖不同调试插件，配置重点也不同。以下是最常遇到的几种情况：
Node.js（ESM + TypeScript）
用 pwa-node（推荐替代旧 node）更稳定，支持源码映射和现代语法：
-
runtimeExecutable：显式指定 Node 可执行路径（如"${workspaceFolder}/node_modules/.bin/ts-node"）； -
args：传参数组，比如["--loader", "ts-node/esm", "src/index.ts"]； -
sourceMaps和outFiles：确保设为true，并指向编译后 JS 文件位置（如["${workspaceFolder}/dist/**/*.js"]）； -
resolveSourceMapLocations：可排除 node_modules 映射，避免跳进第三方代码。
Python 脚本或 Flask/FastAPI
依赖 Python 扩展，注意入口路径和环境隔离：
-
module：运行模块时用（如"flask"），配合args: ["run", "--no-debugger"]； -
python：指定解释器路径（支持${command:python.interpreterPath}动态获取）； -
env：设置环境变量，比如{"FLASK_ENV": "development"}； -
justMyCode：设为true可避免单步进入标准库。
前端（Chrome / Edge）自动打开调试
适合 Vue/React 项目，需搭配 dev server 启动后自动注入调试器：
-
url或file：指定要加载的页面地址（如"http://localhost:3000"）； -
webRoot：告诉调试器源码根路径，用于匹配 sourcemap（必须准确，否则断点灰色无效）； -
trace：设为true可在.vscode/.debug下生成详细日志，排错利器； -
skipFiles：跳过node_modules/**和**/dist/**等干扰路径。
实用技巧与避坑指南
很多调试失败不是因为不会写，而是忽略了上下文细节：
- 配置中的路径一律用正斜杠
/，即使在 Windows 上；变量如${workspaceFolder}不支持嵌套，不能写成${${env:HOME}/project}； - 多个配置共存时，VSCode 默认启用第一个，可通过顶部调试控制栏手动切换；
- 修改
launch.json后无需重启 VSCode，但需重新点击“开始调试”（或F5）才生效； - 如果断点显示为空心圆（未绑定），优先检查：webRoot 是否正确、sourceMap 是否生成、outFiles 是否匹配编译产物路径；
- 想临时改参数？用
configurations内的preLaunchTask触发构建任务，或postDebugTask清理资源。
基本上就这些。launch.json 不复杂，但容易忽略路径、类型、时机三者的咬合关系。多看官方文档对应调试器的 schema（VSCode 里悬停字段就有提示），再结合调试控制台输出的错误信息，很快就能建立直觉。
