在 VSCode 中配置 GDB 调试时指定源代码路径，需要通过 launch.json 文件进行设置。以下是详细步骤：
1. 确保编译时生成调试信息
编译代码时必须添加 -g 选项（以 GCC 为例）：
gcc -g -o my_program my_program.c
2. 配置 VSCode 的调试环境
步骤一：安装必要插件
- 安装官方扩展 C/C++（Microsoft提供）。
- （可选）安装 CodeLLDB（适用于 LLDB 调试器）。
步骤二：创建/修改 launch.json
- 打开项目文件夹，进入调试视图（左侧活动栏的“虫子”图标）。
- 点击齿轮图标（或选择
Run > Open Configurations），生成launch.json。 - 在
configurations中添加或修改以下内容：
{"version": "0.2.0","configurations": [{"name": "(gdb) Launch","type": "cppdbg","request": "launch","program": "${workspaceFolder}/my_program", // 替换为你的程序路径"args": [],"stopAtEntry": false,"cwd": "${workspaceFolder}","environment": [],"externalConsole": false,"MIMode": "gdb",// ↓↓↓ 关键配置：指定源代码路径 ↓↓↓"sourceFileMap": {"/original/build/path": "${workspaceFolder}/src" // 替换为实际路径// 可以添加多个映射},// ↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑"miDebuggerPath": "/usr/bin/gdb" // GDB路径（需确保正确）}]}
3. 关键参数说明
| 参数 | 作用 |
|---|---|
sourceFileMap |
核心配置：将编译时的原始路径映射到本地实际路径（支持多个映射）。 |
/original/build/path |
编译时记录的绝对路径（可通过 readelf -p .debug_str ./my_program 查找）。 |
${workspaceFolder} |
VSCode变量，表示当前工作目录的绝对路径。 |
miDebuggerPath |
GDB的安装路径（Linux默认 /usr/bin/gdb）。 |
4.验证源码加载
- F5启动调试，在断点处暂停时：
- VSCode应自动跳转到正确的源码位置。
- 若提示找不到文件，检查
sourceFileMap是否匹配编译时的原始路径。
5.高级场景
(1)多目录源码映射
"sourceFileMap": {"/old/path1": "/new/path1","/old/path2": "/new/path2"}
(2)远程调试（如Docker/服务器）
需同步本地和远程的代码结构，并通过 sourceFileMap映射远程路径到本地：
"sourceFileMap": {"/remote/code/path/in/container": "${workspaceFolder}/local_code"}
常见问题解决
问题1：断点未生效？
确认二进制文件包含调试信息（通过命令file ./my_program检查输出是否有with debug_info）。问题2：源码不匹配？
使用以下命令查找编译时的原始路径：
readelf -p .debug_str ./my_program | grep -A5 "/home/"
然后在 sourceFileMap中正确映射。
通过以上配置，VSCode即可在GDB调试时准确定位你的源代码！
内容由零声教学AI助手提供，问题来源于学员提问
![[GIN-debug] [WARNING] Creating an Engine instance with the Logger and Recovery middleware already attached.](https://linuxcpp.0voice.com/zb_users/upload/2023/05/202305162234452257235.png)
