g++编译目标文件生成precompiled header导致静态库不可用如何解决

问题产生原因 #

1. GCC 对输入文件后缀有默认的处理规则，.h后缀的C++头文件会被识别为预编译头生成目标，而非需要编译为目标文件的源码。
2. 你执行的编译命令g++ -c static_test.h static_test.cpp -o static_test.o存在错误：同时传入头文件和源码作为编译输入，且多个输入文件搭配-c参数仅指定单个输出文件，最终生成的static_test.o实际是static_test.h对应的预编译头文件，而非static_test.cpp编译得到的、包含fn函数实现的目标文件，没有可用于链接的有效符号。
3. 将预编译头冒充目标文件打包进静态库后，归档文件内没有有效的导出符号，因此链接器报错提示归档没有索引。

解决方法 #

• 第一步：修正编译目标文件的命令，不要将头文件作为编译输入传递给GCC，仅编译cpp源码即可：

  g++ -c static_test.cpp -o static_test.o
  

  编译完成后可执行file static_test.o验证格式，正常会输出对应系统架构的可重定位目标文件格式，而非预编译头。也可以执行nm static_test.o查看符号表，能看到fn函数的符号即为正常。
• 第二步：重新生成静态库，原有命令的s参数已默认生成归档索引，无需额外执行ranlib：

  ar rsv libstatic_test.a static_test.o
  

• 第三步：执行链接测试即可正常编译通过：

  g++ main.cpp libstatic_test.a -o main
  

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