容器编译C项目后，如何让GDB/VSCode识别本地源码路径？

方法1：GDB手动设置路径映射 #

在GDB中通过set substitute-path命令直接映射容器内源码路径到本地路径：

• 启动GDB后执行：set substitute-path /home/user/myProject /opt/git/myProject
• 也可将该命令写入本地用户目录或项目目录下的.gdbinit文件，让GDB每次启动自动加载映射规则。

方法2：VSCode调试配置中添加路径映射 #

修改VSCode的launch.json调试配置文件，新增sourceFileMap字段完成路径映射：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "C/C++: 调试程序",
            "type": "cppdbg",
            "request": "launch",
            "program": "${workspaceFolder}/path/to/your/executable",
            "args": [],
            "stopAtEntry": false,
            "cwd": "${workspaceFolder}",
            "environment": [],
            "externalConsole": false,
            "MIMode": "gdb",
            "setupCommands": [
                {
                    "description": "启用整齐打印",
                    "text": "-enable-pretty-printing",
                    "ignoreFailures": true
                }
            ],
            "sourceFileMap": {
                "/home/user/myProject": "/opt/git/myProject"
            }
        }
    ]
}

该配置会告知VSCode调试器，将容器编译时记录的源码路径/home/user/myProject替换成本地实际路径/opt/git/myProject。

方法3：编译阶段直接替换路径（可选） #

如果可以重新编译项目，可在gcc编译时通过-fdebug-prefix-map参数直接修改调试信息中的路径：

• 编译命令示例：gcc -g -fdebug-prefix-map=/home/user/myProject=/opt/git/myProject -o my_program my_program.c
  生成的可执行文件会直接记录本地源码路径，调试时无需额外配置映射规则。

内容的提问来源于stack exchange，提问作者Clément