Android Studio如何单步跟踪进入外部静态链接原生库代码

Android Studio 原生代码调试底层默认使用 LLDB 调试器，和 XCode 的调试核心完全一致，支持同源映射逻辑，仅配置入口未直接暴露在显性UI中，支持临时单次配置和永久自动配置两种模式。

临时单次调试配置（操作逻辑与XCode一致） #

• 正常启动应用原生调试会话，在外部库函数的调用位置打端点，触发断点后暂停
• 切换到底部 Debug 面板的 LLDB 控制台标签页
• 先通过反汇编视图步进进入目标外部库函数，确认调试器已加载该静态库符号，执行命令查询符号内记录的原始编译路径：

  image lookup -vn <目标外部库函数名>
  

• 在返回结果中找到 CompileUnit 字段，对应内容就是编译.a文件时嵌入的原始源码绝对路径，提取其中的源码根目录前缀（例如原编译环境源码根路径为 /opt/build/externallib/，你本地存放该库源码的路径为 D:/workspace/thirdparty/externallib/）
• 执行源映射配置命令：

  settings set target.source-map <原始编译路径前缀> <本地源码路径前缀>
  

• 配置完成后即可正常单步进入外部库源码，支持断点、变量查看等全量调试能力。

永久自动配置（无需每次调试重复操作） #

• 打开 Run -> Edit Configurations，选中当前使用的调试配置，切换到 Debugger 标签页
• 在Debug Symbols配置项下方找到LLDB启动命令配置区，将上述target.source-map配置命令添加到调试启动时自动执行的命令列表中，保存配置
• 后续每次启动调试会话，LLDB会自动加载该源映射规则，无需重复手动输入。

常见问题排查 #

• 确认导入的.a文件与当前构建的ABI架构完全匹配，不要混用不同架构、不同编译选项生成的静态库，否则会出现符号加载异常
• 检查最终链接生成的so文件是否裁剪了静态库的调试符号，如果是自定义CMake/ndk-build构建规则，需要关闭对应模块的strip选项，符号被裁剪后源映射无法生效
• 配置完成后仍无法跳转源码时，可在LLDB控制台执行image list命令，确认对应静态库已被正确加载，不存在(No symbol)提示。

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