–whole-archive详解

一、基础概念

  --whole-archive是gcc编译器的一个参数，用来指定链接器(ld)在链接时将一个库文件(.a文件)中的所有目标文件(o文件)都包含进去，而不是像默认情况下只包含库文件中被引用的目标文件。该参数可用于解决静态库中未使用目标文件被优化掉的问题，也可用来在链接时强制所有与该静态库相关的符号被解析到该库中。

二、参数使用

使用–whole-archive参数的一般格式为：gcc main.o lib_xxx.a –whole-archive lib_yyy.a –no-whole-archive -o main。其中–whole-archive和–no-whole-archive之间要写需要链接的库文件名，在这个例子中即为lib_yyy.a。如果需要链接多个库文件，可以在–whole-archive和–no-whole-archive之间分别写上对应的库文件名。需要注意的是，在使用–whole-archive时，如果库文件在编译器命令行中被引用了多次，那么其中所有目标文件都将被包含进最终结果中，这也是需要注意的一点，避免出现不必要的错误。

三、应用场景

1、避免静态库中被优化掉的目标文件
在开发中，我们会编写一些静态库，但是在编译时，如果库文件中有一些目标文件未被其它目标文件引用，编译器为了优化性能会自动忽略这些未被引用的目标文件，导致最终生成的静态库缺少某些目标文件。为了解决这个问题，可以使用–whole-archive来指定编译器强制将库文件中的所有目标文件都包含进来，这样就不会多出未包含的目标文件，从而解决了目标文件被优化掉的问题。

2、强制链接库文件中的函数
在开发中，如果有多个库文件，这些库文件中的函数可能会产生冲突，导致最终链接不成功。可以使用–whole-archive来解决这个问题，强制将库文件中的函数都链接进去，从而保证函数的正确性。

3、强制链接VS的C/C++运行库
在使用VS编译C/C++程序时，程序默认会绑定到VS的C/C++运行库。但有些情况下，可能需要使用第三方的C/C++运行库，此时可以使用–whole-archive来强制链接第三方运行库，从而使用第三方运行库，而不是VS的C/C++运行库。

四、示例代码

以下代码演示了–whole-archive参数的应用，使用lib_a.a和lib_b.a两个库文件通过–whole-archive参数链接所有库文件中的目标文件，最终生成可执行文件main。

1、先编译库文件lib_a.a和lib_b.a：
   $gcc -c a1.c a2.c
   $ar rcs lib_a.a a1.o a2.o
   $gcc -c b1.c b2.c
   $ar rcs lib_b.a b1.o b2.o

2、编译可执行程序：
   $gcc main.c lib_a.a lib_b.a –whole-archive -o main