gcc 13.2 链接静态库报 undefined reference 顺序为什么反了

C 项目用 gcc 13.2 编,加了个 util 模块之后报 undefined reference to `crc32_init',collect2 返回 1。libutil.a 就在 ./lib 目录下,前一天还好好的。

第一反应是忘加 -lutil,补上还是同样的错。nm -C libutil.a | grep crc32 看,符号是 T,确实在库里。file 看架构也对,都是 x86-64,不是混进了 32 位的包。

把完整命令打出来才看明白,-lutil 写在 main.o 前面。静态库是单遍扫描,从左往右,扫到库的时候还没有任何地方引用 crc32_init,整个 .a 就被跳过,后面再出现引用也没人回头找。

把库挪到所有 .o 后面,链接一次通过。中间还遇到 liba 依赖 libb、libb 又回调 liba 的情况,单遍扫描解决不了,得用 -Wl,--start-group 和 --end-group 把一组库包起来反复扫,代价是链接慢 2 秒。

另外两个坑顺手记下。-L 写成相对路径后,在别的目录执行 make 会找不到库;CMake 里 target_link_libraries 传入的顺序就是最终命令行顺序,写成 PUBLIC 还是 PRIVATE 不改变这个事实。

确认口径:make clean 后全量重编 41 秒通过;readelf -d 查二进制没有未定义符号;跑单元测试 118 个全过;再把 -lutil 挪回前面验证一次,错误能稳定复现。

gcc -o app main.o parse.o -L./lib -lutil
nm -C libutil.a | grep crc32_init
gcc -o app main.o -Wl,--start-group -la -lb -Wl,--end-group

您可以还会对下面的文章感兴趣: