远程嵌入式设备GDB调试时，如何解决主机与设备源码路径不匹配问题？

方法1：编译阶段通过CMake配置路径映射（推荐） #

CMake默认用绝对路径生成调试信息，但可以通过添加-fdebug-prefix-map编译选项，直接将调试信息中的主机路径替换为远程设备路径，该选项会同时修改DW_AT_name和DW_AT_comp_dir字段：

在项目的CMakeLists.txt中添加以下配置：

# 替换主机源码根目录为远程设备上的源码存储路径
set(HOST_SOURCE_ROOT "/home/david")
set(REMOTE_SOURCE_ROOT "/remote/path/to/your/source")

set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -fdebug-prefix-map=${HOST_SOURCE_ROOT}=${REMOTE_SOURCE_ROOT}")
set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -fdebug-prefix-map=${HOST_SOURCE_ROOT}=${REMOTE_SOURCE_ROOT}")

重新编译后，二进制文件的调试信息中所有原主机路径都会被替换为远程设备的对应路径，远程GDB可直接定位到源码文件。

方法2：在GDB中设置路径替换（无需重新编译） #

如果无法重新编译，可直接在GDB中使用set substitute-path命令全局替换调试信息中的路径，该命令能覆盖包括DW_AT_name在内的所有路径字段：

1. 启动远程设备上的GDB，或通过ADB连接远程GDBServer后在本地GDB中执行：

# 将主机路径替换为远程设备上的源码实际路径
set substitute-path /home/david /remote/path/to/your/source

2. 可通过show substitute-path命令查看当前的路径替换规则，确认设置生效。

此方法无需修改编译流程，直接在调试阶段修正路径映射，适合临时调试场景。

补充说明 #

• directory命令仅添加源码搜索路径，不会替换调试信息中已有的绝对路径，因此无法解决你的问题；而substitute-path是专门针对调试信息路径替换设计的，能覆盖所有相关路径字段。

内容的提问来源于stack exchange，提问作者David Di Lorenzo