解密VS Code的launch.json：配置您的调试会话

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 包含以下关键部分：

话袋AI笔记

话袋AI笔记, 像聊天一样随时随地记录每一个想法，打造属于你的个人知识库，成为你的外挂大脑

195

查看详情

• 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 能让它成为开发的助力。

以上就是解密VS Code的launch.json：配置您的调试会话的详细内容，更多请关注php中文网其它相关文章！