掌握launch.json高级配置可显著提升调试效率，包括预启动任务、attach模式、条件断点、多服务复合启动等技巧，实现高效精准的开发调试。
调试是开发过程中不可或缺的一环，而 VSCode 提供了强大且灵活的调试能力。理解并掌握 launch.json 配置文件的高级用法，能显著提升调试效率和精准度。本文将深入剖析 launch.json 的核心配置项，并介绍一些实用的高级技巧。
理解 launch.json 基本结构
launch.json 位于项目根目录下的 .vscode 文件夹中，用于定义调试启动配置。每个配置包含多个关键字段：
- name：调试配置的名称，显示在调试面板中
- type：调试器类型，如 node、python、chrome 等
- request：请求类型，launch（启动程序）或 attach（附加到进程）
- program：要运行的入口文件路径，通常配合 ${workspaceFolder} 使用
- cwd：程序运行时的工作目录
- env：设置环境变量
示例配置（Node.js）：
{
"name": "Launch App",
"type": "node",
<strong>"request": "launch"</strong>,
"program": "${workspaceFolder}/app.js",
"cwd": "${workspaceFolder}",
"env": {
"NODE_ENV": "development"
}
}使用预启动任务自动构建
在调试前自动执行编译或构建任务，可避免手动操作。通过 preLaunchTask 字段关联 tasks.json 中定义的任务。
- 确保 tasks.json 中的任务已标记为“默认构建任务”或具有唯一标识
- preLaunchTask 值需与任务名完全一致
- 适用于 TypeScript 编译、Webpack 打包等场景
配置示例：
"preLaunchTask": "tsc: build - tsconfig.json"
调试启动时，VSCode 会先编译代码再启动调试器，确保运行的是最新版本。
附加到运行中的进程（Attach 模式）
当程序已运行（如后台服务、容器内应用），可使用 attach 模式进行调试。
- 设置 request 为 "attach"
- 指定进程 ID（processId）或端口（port）
- 常用于调试长时间运行的服务或复现特定状态
Node.js 进程附加示例：
Scrapfly SDK TypeScript
下载
使用 Scrapfly SDK（scrapfly-sdk）在 TypeScript 或 JavaScript 中进行网页抓取，用于用户请求抓取 URL、绕过反爬虫防护、渲染页面等场景。
{
"name": "Attach to Node",
"type": "node",
<strong>"request": "attach"</strong>,
"port": 9229,
"restart": true
}启动前需确保 Node.js 进程以 --inspect 参数运行。
条件断点与日志断点进阶用法
除了基础断点，VSCode 支持更智能的断点类型：
-
条件断点：右键断点 → “编辑断点”，输入表达式（如
user.id === 100） - 命中条件：仅在断点被触发 N 次后暂停
-
日志断点：不中断执行，输出表达式值到调试控制台（如
用户登录: {user.name}）
这类断点特别适合在循环或高频调用中排查问题，避免频繁中断影响调试节奏。
多配置与复合启动
复杂项目可能需要同时启动多个服务。launch.json 支持 compound 配置：
- 定义多个调试配置
- 使用 compounds 将它们组合在一起
- 一键启动前后端、微服务等协同调试
复合配置示例：
{
"name": "Full Stack Debug",
"configurations": ["Launch Backend", "Launch Frontend"]
}前提是 “Launch Backend” 和 “Launch Frontend” 已在 configurations 中定义。
基本上就这些。掌握这些高级配置后，调试不再是简单打断点，而是变成一种高效的问题定位手段。合理利用 launch.json，能让 VSCode 成为你最顺手的调试利器。
