vscode gdb如何指定调试时的代码路径-Go服务器开发

在 VSCode 中使用 GDB 调试时，若遇到源码路径不匹配的问题（例如代码编译时的路径与本地路径不一致），可以通过以下方法指定正确的源代码路径：

方法1：通过 `launch.json` 的 `sourceFileMap` 配置

这是最常用的方式，适用于本地或远程调试。

步骤

打开 launch.json
- 进入 VSCode 的调试界面（左侧活动栏的“虫子”图标）。
- 点击齿轮图标（或选择 Run > Open Configurations）打开/创建 .vscode/launch.json。

修改 configurations
在 GDB 调试配置中添加 "sourceFileMap"，将编译时的路径映射到本地实际路径：

{
   "version": "0.2.0",
   "configurations": [
       {
           "name": "(gdb) Launch",
           "type": "cppdbg",
           "request": "launch",
           "program": "${workspaceFolder}/build/my_program", // 替换为你的程序路径
           "args": [],
           "stopAtEntry": false,
           "cwd": "${workspaceFolder}",
           "environment": [],
           "externalConsole": false,
           "MIMode": "gdb",
           // ↓↓↓ 关键配置：指定源代码映射 ↓↓↓
           "sourceFileMap": {
               "/original/build/path/to/src": "${workspaceFolder}/src", // 替换为实际映射关系
               "/another/path/in/binary": "${workspaceFolder}/lib"     // 可添加多个映射
           },
           // ↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑
           "miDebuggerPath": "/usr/bin/gdb" // GDB路径（Linux默认 /usr/bin/gdb）
       }
   ]
}

如何查找编译时的原始路径？
如果不知道二进制文件记录的源码路径，可以使用：
```
readelf -p .debug_str ./my_program | grep "/home/"  
```
或者用 GDB 命令查看：
```
gdb ./my_program
(gdb) info sources
```

方法2：使用 GDB 的 `set substitute-path`（临时方案）

如果不想修改 launch.json，可以在调试过程中手动输入 GDB 命令：

(gdb) set substitute-path /original/path /new/path

例如：

(gdb) set substitute-path /home/user/old_src /home/user/new_src

⚠️ 注意：此方式仅在当前调试会话有效，关闭后需重新设置。

方法3：确保编译时使用相对路径

如果可能，建议在编译时使用相对路径而非绝对路径，避免后续调试问题：

gcc -g -o my_program ./src/main.c      # ✅推荐用相对路径编译

这样生成的调试信息会直接记录相对位置，减少映射需求。

常见问题排查

问题	解决方案
断点无法命中？	检查是否已正确编译 `-g`，并确认二进制包含调试信息 (`file ./my_program`)
源码仍然找不到？	检查 `sourceFileMap`是否完全匹配二进制中的记录（可用 `readelf -p .debug_str`）
远程/Docker调试失败？	确保容器内外的代码结构一致，并在 `sourceFileMap`中正确映射远程和本地目录。