一、launch.json
常见配置项
在 Visual Studio Code (VSCode) 中,launch.json
文件用于配置调试器的行为。这个文件包含了一系列的参数,用来控制调试会话的细节,如程序路径、调试器类型、环境变量、调试设置等。
launch.json
文件的配置项比较多,下面我会列出常用的配置项,并附上一些可能的值以及它们的功能。
launch.json
配置项通常可以分为以下几类:
-
version
- 类型:字符串
- 描述:指定
launch.json
文件的版本。 - 示例:
"version": "0.2.0"
-
configurations
- 类型:数组
- 描述:调试配置的数组,每个配置项对应一个调试会话。
- 示例:
"configurations": [ { // 配置项 } ]
-
调试配置项 每个调试配置项都可以包含多个子项,用来控制具体的调试行为。以下是常见的调试配置项:
1. name
- 类型:字符串
- 描述:该配置的名称,会显示在 VSCode 的调试面板中,帮助你区分不同的调试配置。
- 示例:
"name": "C++: g++ 调试"
2. type
- 类型:字符串
- 描述:指定调试器的类型,决定了使用哪种调试工具。常见的类型有:
"cppdbg"
:用于 C/C++ 程序的调试。"node"
:用于 Node.js 程序的调试。"python"
:用于 Python 程序的调试。"chrome"
:用于前端 JavaScript 程序的调试(使用 Chrome 浏览器)。
- 示例:
"type": "cppdbg"
3. request
- 类型:字符串
- 描述:指定调试请求的类型,有两个主要选项:
"launch"
:启动并调试程序。"attach"
:附加到已运行的程序(用于远程调试或在程序已经运行的情况下调试)。
- 示例:
"request": "launch"
4. program
- 类型:字符串
- 描述:指定要调试的程序的路径。对于 C/C++ 程序,通常是编译后生成的可执行文件。
- 示例:
"program": "${workspaceRoot}/${fileBasenameNoExtension}.exe"
5. args
- 类型:数组
- 描述:传递给调试程序的命令行参数。
- 示例:
"args": ["arg1", "arg2"]
6. stopAtEntry
- 类型:布尔值
- 描述:指定是否在程序的入口处(如
main()
)停止。默认值为false
。 - 示例:
"stopAtEntry": true
7. cwd
(Current Working Directory)
- 类型:字符串
- 描述:指定调试会话的当前工作目录。如果不指定,默认使用项目的根目录。
- 示例:
"cwd": "${workspaceRoot}"
8. env
- 类型:对象
- 描述</