最近在Linux下編程發(fā)現(xiàn)一個詭異的現(xiàn)象，就是在鏈接一個靜態(tài)庫的時候總是報錯藕帜，類似下面這樣的錯誤：(.text+0x13): undefined reference to `func'
關(guān)于undefined reference這樣的問題，大家其實經(jīng)常會遇到塞帐，在此，我以詳細(xì)地示例給出常見錯誤的各種原因以及解決方法，希望對初學(xué)者有所幫助死遭。
1. 鏈接時缺失了相關(guān)目標(biāo)文件（.o）
** **測試代碼如下：
然后編譯覆享。
gcc -c test.c
gcc –c main.c
得到兩個 .o 文件伙窃，一個是 main.o澄耍，一個是 test.o ，然后我們鏈接 .o 得到可執(zhí)行程序：
gcc -o main main.o
這時谤职，你會發(fā)現(xiàn)饰豺，報錯了：
main.o: In function main': main.c:(.text+0x7): undefined reference totest'
collect2: ld returned 1 exit status
這就是最典型的undefined reference錯誤，因為在鏈接時發(fā)現(xiàn)找不到某個函數(shù)的實現(xiàn)文件允蜈，本例中test.o文件中包含了test()函數(shù)的實現(xiàn)冤吨，所以如果按下面這種方式鏈接就沒事了蒿柳。
gcc -o main main.o test.o
【擴展】：其實上面為了讓大家更加清楚底層原因，我把編譯鏈接分開了漩蟆，下面這樣編譯也會報undefined reference錯垒探，其實底層原因與上面是一樣的。
gcc -o main main.c //缺少test()的實現(xiàn)文件
需要改成如下形式才能成功怠李，將test()函數(shù)的實現(xiàn)文件一起編譯圾叼。
gcc -o main main.c test.c //ok,沒問題了
2. 鏈接時缺少相關(guān)的庫文件（.a/.so）
在此，只舉個靜態(tài)庫的例子捺癞，假設(shè)源碼如下夷蚊。
先把test.c編譯成靜態(tài)庫(.a)文件
gcc -c test.c
ar -rc test.a test.o
至此，我們得到了test.a文件髓介。我們開始編譯main.c
gcc -c main.c
這時惕鼓，則生成了main.o文件，然后我們再通過如下命令進行鏈接希望得到可執(zhí)行程序唐础。
gcc -o main main.o
你會發(fā)現(xiàn)箱歧，編譯器報錯了：
/tmp/ccCPA13l.o: In function main': main.c:(.text+0x7): undefined reference totest'
collect2: ld returned 1 exit status
其根本原因也是找不到test()函數(shù)的實現(xiàn)文件，由于該test()函數(shù)的實現(xiàn)在test.a這個靜態(tài)庫中的一膨，故在鏈接的時候需要在其后加入test.a這個庫呀邢，鏈接命令修改為如下形式即可。
gcc -o main main.o ./test.a //注：./ 是給出了test.a的路徑
【擴展】：同樣豹绪，為了把問題說清楚驼鹅，上面我們把代碼的編譯鏈接分開了，如果希望一次性生成可執(zhí)行程序森篷，則可以對main.c和test.a執(zhí)行如下命令。
gcc -o main main.c ./test.a //同樣豺型，如果不加test.a也會報錯
3. 鏈接的庫文件中又使用了另一個庫文件
這種問題比較隱蔽仲智，也是我最近遇到的與網(wǎng)上大家討論的不同的問題，舉例說明如下姻氨，首先钓辆，還是看看測試代碼。
從上圖可以看出肴焊，main.c調(diào)用了test.c的函數(shù)前联，test.c中又調(diào)用了fun.c的函數(shù)。 首先娶眷，我們先對fun.c似嗤，test.c，main.c進行編譯届宠，生成 .o文件烁落。
gcc -c func.c
gcc -c test.c
gcc -c main.c
然后乘粒，將test.c和func.c各自打包成為靜態(tài)庫文件。
ar –rc func.a func.o
ar –rc test.a test.o
這時伤塌，我們準(zhǔn)備將main.o鏈接為可執(zhí)行程序灯萍，由于我們的main.c中包含了對test()的調(diào)用，因此每聪，應(yīng)該在鏈接時將test.a作為我們的庫文件旦棉，鏈接命令如下。
gcc -o main main.o test.a
這時药薯，編譯器仍然會報錯绑洛，如下：
test.a(test.o): In function test': test.c:(.text+0x13): undefined reference tofunc'
collect2: ld returned 1 exit status
就是說，鏈接的時候果善，發(fā)現(xiàn)我們的test.a調(diào)用了func()函數(shù)诊笤，找不到對應(yīng)的實現(xiàn)。由此我們發(fā)現(xiàn)巾陕，原來我們還需要將test.a所引用到的庫文件也加進來才能成功鏈接讨跟，因此命令如下。
gcc -o main main.o test.a func.a
ok鄙煤，這樣就可以成功得到最終的程序了晾匠。同樣，如果我們的庫或者程序中引用了第三方庫（如pthread.a）則同樣在鏈接的時候需要給出第三方庫的路徑和庫文件梯刚，否則就會得到undefined reference的錯誤凉馆。
4 多個庫文件鏈接順序問題
這種問題也非常的隱蔽，不仔細(xì)研究你可能會感到非常地莫名其妙亡资。我們依然回到第3小節(jié)所討論的問題中澜共，在最后，如果我們把鏈接的庫的順序換一下锥腻，看看會發(fā)生什么結(jié)果嗦董？
gcc -o main main.o func.a test.a
我們會得到如下報錯.
test.a(test.o): In function test': test.c:(.text+0x13): undefined reference tofunc'
collect2: ld returned 1 exit status
因此，我們需要注意瘦黑，在鏈接命令中給出所依賴的庫時京革，需要注意庫之間的依賴順序，依賴其他庫的庫一定要放到被依賴庫的前面幸斥，這樣才能真正避免undefined reference的錯誤匹摇，完成編譯鏈接。
5. 在c++代碼中鏈接C語言的庫
如果你的庫文件由c代碼生成的甲葬，則在c++代碼中鏈接庫中的函數(shù)時廊勃，也會碰到undefined reference的問題。下面舉例說明经窖。
首先供搀，編寫c語言版庫文件：
編譯隅居，打包為靜態(tài)庫：test.a
gcc -c test.c
ar -rc test.a test.o
至此，我們得到了test.a文件葛虐。下面我們開始編寫c++文件main.cpp
然后編譯main.cpp生成可執(zhí)行程序：
g++ -o main main.cpp test.a
會發(fā)現(xiàn)報錯：
/tmp/ccJjiCoS.o: In function main': main.cpp:(.text+0x7): undefined reference totest()'
collect2: ld returned 1 exit status
原因就是main.cpp為c++代碼胎源，調(diào)用了c語言庫的函數(shù)，因此鏈接的時候找不到屿脐，解決方法：即在main.cpp中涕蚤，把與c語言庫test.a相關(guān)的頭文件包含添加一個extern "C"的聲明即可。例如的诵，修改后的main.cpp如下：
g++ -o main main.cpp test.a
再編譯會發(fā)現(xiàn)万栅，問題已經(jīng)成功解決。
