如何向lldb导入自定义调试头文件以解析无调试符号的结构体

你遇到的报错核心原因是lldb的表达式求值环境中缺少struct test_st的完整类型定义，只要把自定义类型的定义导入到lldb的Clang解析环境即可解决，以下是两种可行配置方案：

方案一：临时导入头文件（单次调试使用，操作最简） #

• 首先将你的结构体定义保存为独立头文件，比如命名为custom_types.h，注意补全依赖的标准头文件，语法要符合C规范：

#include <stdint.h>
struct test_st {
    uint64_t a;
    uint64_t b;
};

注意结构体定义末尾必须加分号，否则会触发语法报错。

• 进入lldb调试会话后，执行导入命令，路径用绝对路径避免找不到文件：

(lldb) expression #import "/path/to/your/custom_types.h"

• 导入完成后直接执行你需要的类型转换命令即可得到预期输出：

(lldb) p *(struct test_st*)0x0000000283e4db40

方案二：modulemap配置（持久生效，多调试会话复用） #

如果需要频繁使用自定义类型，可以通过modulemap配置实现一次配置多次使用，解决你之前modulemap无法识别的问题，操作步骤如下：

• 新建一个专门存放自定义类型的目录，比如~/lldb_custom_modules，放入两个文件：

1. 前面用到的custom_types.h头文件，内容和方案一一致
2. 同目录下新建module.modulemap文件，内容如下：

module CustomTypes {
    header "custom_types.h"
    export *
}

• 编辑lldb全局配置文件~/.lldbinit（没有则新建），添加以下配置：

# 添加自定义module的搜索路径
settings set target.clang-module-search-paths "~/lldb_custom_modules"
# 配置快捷加载命令，也可以配置成启动自动加载
command regex import_custom 's/^/expression @import CustomTypes/'

• 后续每次启动lldb，只要执行import_custom命令即可加载所有你定义在该module中的自定义类型，不需要重复导入头文件。

常见问题排查 #

• 若导入时提示头文件找不到，可手动添加头文件搜索路径：

(lldb) settings set target.inferior-extra-cc-options "-I/你的头文件所在目录的绝对路径"

• 若解析出来的成员值和实际内存不符，大概率是结构体对齐规则不匹配，可在结构体定义中添加__attribute__((packed))取消默认对齐，或者根据实际内存布局调整成员顺序、类型宽度。
• 所有文件路径尽量使用绝对路径，避免lldb工作目录变化导致文件找不到。

内容的提问来源于stack exchange，提问作者gkpln3