### 如何在 VS Code 中手动创建或自动生成 `launch.json` 配置文件 #### 自动生成 `launch.json` 当尝试启动调试会话而没有现有的 `launch.json` 文件时，VS Code 提供了简便的方法来引导用户完成配置过程。按下 F5 键之后，如果检测到缺少必要的调试配置，则会出现一个对话框询问要添加的配置类型[^1]。 选择适用于 C/C++ 调试选项（例如 `(gdb) Launch` 或者 `(msvc) Launch`），这取决于所使用的编译器和操作系统环境。一旦选择了特定类型的调试配置，IDE 将会在 `.vscode` 文件夹内创建默认模板化的 `launch.json` 文件，并预填一些基本参数以便立即使用[^2]。 #### 手动创建 `launch.json` 对于更精细控制或是特殊需求的情况，可以按照以下方式手工建立： 进入项目根目录下的隐藏文件夹`.vscode`(如果没有此文件夹则自行新建)，在此处利用 JSON 结构定义所需的调试设置。下面给出了一种典型的用于 GCC 编译 C 程序的简单例子[^3]: ```json { "version": "0.2.0", "configurations": [ { "name": "(gcc) Launch", "type": "cppdbg", "request": "launch", "program": "${workspaceFolder}/a.out", // 替换为实际执行程序路径 "args": [], "stopAtEntry": false, "cwd": "${fileDirname}", "environment": [], "externalConsole": true, "MIMode": "gdb", "setupCommands": [ { "description": "Enable pretty-printing for gdb", "text": "-enable-pretty-printing", "ignoreFailures": true } ], "preLaunchTask": "build", // 如果有对应的构建任务名就填写这里 "miDebuggerPath": "/usr/bin/gdb" } ] } ``` 上述代码片段展示了如何指定目标平台、入口点以及其它重要的运行期属性；同时也指定了与之关联的任务名称(preLaunchTask), 这样可以在每次开始调试前自动调用相应的编译指令。