launch.json是VS Code中用于定义调试配置的文件，位于项目根目录的.vscode文件夹下，通过配置name、type、request、program等字段，可精确控制程序启动方式、环境变量、运行参数及调试目标，支持多种运行时如Node.js、Python、Chrome等；典型应用场景包括调试Express服务器、附加到Node进程、前端页面调试及带参运行脚本，配合compounds可实现多服务联合调试，利用变量和智能提示提升可移植性与编写效率，正确配置后能显著提升调试效率并解决断点无效等问题。
调试是开发过程中不可或缺的一环，而 VS Code 的 launch.json 文件正是控制调试会话的核心配置文件。它让你能精确控制程序如何启动、使用哪个环境、传入什么参数，甚至连接远程服务。理解并正确配置 launch.json，能极大提升调试效率。
什么是 launch.json？
该文件位于项目根目录下的 .vscode/launch.json，用于定义一个或多个调试配置。每次你在 VS Code 中点击“运行和调试”侧边栏的启动按钮时，实际上是在执行其中某一条配置。
VS Code 支持多种运行时环境，比如 Node.js、Python、Chrome 浏览器、.NET 等，每种环境都有对应的调试器和可配置项。
基本结构与常用字段
一个典型的 launch.json 包含以下关键部分：
智能网站优化SiteSEO1.52
下载
系统易学易懂，用户只需会上网、不需学习编程及任何语言，只要使用该系统平台，只要会打字，即可在线直接完成建站所有工作。本程序适合不懂php环境配置的新手用来在本机调试智能SiteSEO网站优化软件，安装过程极其简单。您的网站地址：http://localhost您的网站后台：登录地址： http://localhost/admin.php密 码： admin服务器套件所包含的软件：nginx-0.7
- name：调试配置的名称，显示在 VS Code 的下拉菜单中
- type：调试器类型，如 node、python、pwa-chrome
- request：请求类型，常见为 launch（启动程序）或 attach（附加到已运行进程）
- program：要运行的入口文件路径，常配合变量如 ${workspaceFolder}
- env：设置环境变量，对区分开发/生产行为很有用
- console：指定输出终端，可选 internalConsole、integratedTerminal 或 externalTerminal
常见使用场景示例
不同开发需求需要不同的配置方式：
- 调试 Express 应用：设置 program 指向服务器入口，并启用自动重启
- 附加到运行中的 Node 进程：将 request 设为 attach，配合 port 字段连接调试端口
- 前端代码调试：使用 chrome 类型配置，通过 url 打开页面并注入调试器
- 带参数启动脚本：使用 args 数组传入命令行参数，如 --config dev
实用技巧与注意事项
高效使用 launch.json 需注意一些细节：
- 利用 VS Code 内置的智能提示编写配置，输入字段时会自动补全可用选项
- 使用变量提高可移植性，例如 ${file} 表示当前打开的文件
- 可配置多个调试组合，通过 compounds 同时启动前后端服务
- 确保目标运行时已安装对应调试扩展，如 Python 调试器需安装官方 Python 扩展
- 配置错误时，VS Code 通常会在“运行和调试”视图中给出明确提示
基本上就这些。掌握 launch.json 不仅能解决“为什么断点不生效”这类问题，还能让调试变得更主动、更精准。配置看似复杂，但一旦建立模板，后续项目复用起来非常方便。调试本不该是负担，合理的 setup 能让它成为开发的助力。
