VSCode的调试配置（launch.json）怎么写？

技术教程
2025-10-11 22:49:01

launch.json用于配置VSCode调试，包含version和configurations数组，常见字段有name、type、request、program等，支持Node.js、Python、C++等语言调试，可通过调试面板快速生成。

vscode的调试配置（launch.json）怎么写？

VSCode 的调试配置通过项目根目录下的 .vscode/launch.json 文件定义。这个文件告诉 VSCode 如何启动和调试你的程序。下面介绍常见写法和关键字段。

美图云修

商业级AI影像处理工具

61 查看详情美图云修

1. 基本结构

每个 launch.json 都包含一个 version 和一个 configurations 数组，数组中每个对象代表一种调试配置：

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "调试 Node.js 程序",
      "type": "node",
      "request": "launch",
      "program": "${workspaceFolder}/index.js"
    }
  ]
}

2. 常用字段说明

以下是核心字段的含义：

name：配置名称，出现在调试侧边栏下拉菜单中
type：调试器类型，如 node（Node.js）、python、cppdbg（C++）等
request：请求类型，通常为 launch（启动程序）或 attach（附加到已运行进程）
program：要运行的入口文件，常用变量如 ${workspaceFolder} 表示项目根目录
args：传递给程序的命令行参数，以数组形式书写
cwd：程序运行时的工作目录
env：环境变量设置
console：控制台类型，可选 integratedTerminal、internalConsole 或 externalTerminal

3. 常见语言示例

Node.js 调试

{
  "name": "启动应用",
  "type": "node",
  "request": "launch",
  "program": "${workspaceFolder}/app.js",
  "cwd": "${workspaceFolder}",
  "console": "integratedTerminal",
  "env": {
    "NODE_ENV": "development"
  }
}

Python 调试（需安装 Python 扩展）

{
  "name": "运行 Python 文件",
  "type": "python",
  "request": "launch",
  "program": "${file}",
  "console": "integratedTerminal",
  "args": ["--verbose"],
  "cwd": "${workspaceFolder}"
}

C++ 调试（使用 gdb）

{
  "name": "调试 C++",
  "type": "cppdbg",
  "request": "launch",
  "program": "${workspaceFolder}/build/app",
  "args": [],
  "stopAtEntry": false,
  "cwd": "${workspaceFolder}",
  "environment": [],
  "externalConsole": false,
  "MIMode": "gdb",
  "miDebuggerPath": "/usr/bin/gdb",
  "setupCommands": [
    {
      "description": "启用整齐打印",
      "text": "-enable-pretty-printing",
      "ignoreFailures": true
    }
  ]
}