Clang使用符号链接链接静态库时丢失调试信息的问题

直接使用目标文件链接生成二进制文件时，程序崩溃能显示完整行号：

clang -o binary build/lib/*.o build/bin/*.o

所有目标文件均通过-g编译，包含完整调试信息。

但将部分目标文件打包为静态库后，再链接生成的二进制文件崩溃时，仅非静态库的目标文件有行号，静态库内的目标文件无行号：

1. 打包静态库命令：

ar -q lib.a build/lib/*.o

2. 链接二进制命令：

clang -o binary lib.a build/bin/*.o

进一步排查发现问题与符号链接强相关：仅当链接命令使用含符号链接的绝对路径时才会触发问题：

clang -o binary /symlink/to/lib.a /fullpath/to/build/bin/*.o

若使用不含符号链接的绝对路径，或直接在静态库所在目录使用文件名链接，调试信息显示正常。

环境：macOS Sonoma，Clang版本为Xcode 14.3.1附带的clang-1403.0.22.14.1

这是macOS平台上Clang/LLD链接器处理静态库调试信息时的路径解析bug：当通过符号链接路径引用静态库时，链接器无法正确解析库内目标文件中记录的源文件路径——目标文件的调试信息基于编译时的路径生成，符号链接会干扰链接器对静态库实际位置的判断，导致无法关联到对应的源文件。

有几种可行的解决方式：

• 使用静态库的实际物理路径替代符号链接路径执行链接，避免路径解析干扰。
• 切换到静态库所在的实际目录，直接用文件名lib.a作为链接参数。
• 改用libtool替代ar打包静态库，它对调试信息的路径处理更友好：

libtool -static -o lib.a build/lib/*.o

• 升级Clang版本：更新到Xcode 15及以上版本，该路径解析bug已被修复。

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