–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