Prayer

1. (.text+0x13): undefined reference to `func' 

    關(guān)于undefined reference這樣的問(wèn)題，大家其實(shí)經(jīng)常會(huì)遇到，在此，我以詳細(xì)地示例給出常見(jiàn)錯(cuò)誤的各種原因以及解決方法，希望對(duì)初學(xué)者有所幫助。

1.  鏈接時(shí)缺失了相關(guān)目標(biāo)文件（.o）

    測(cè)試代碼如下：

    然后編譯。

1. gcc -c test.c  
2. gcc –c main.c 

    得到兩個(gè) .o 文件，一個(gè)是 main.o，一個(gè)是 test.o ，然后我們鏈接 .o 得到可執(zhí)行程序：

1. gcc -o main main.o 

    這時(shí)，你會(huì)發(fā)現(xiàn)，報(bào)錯(cuò)了：

1. main.o: In function `main':  
2. main.c:(.text+0x7): undefined reference to `test'  
3. collect2: ld returned 1 exit status 

    這就是最典型的undefined reference錯(cuò)誤，因?yàn)樵阪溄訒r(shí)發(fā)現(xiàn)找不到某個(gè)函數(shù)的實(shí)現(xiàn)文件，本例中test.o文件中包含了test()函數(shù)的實(shí)現(xiàn)，所以如果按下面這種方式鏈接就沒(méi)事了。

1. gcc -o main main.o test.o 

   【擴(kuò)展】：其實(shí)上面為了讓大家更加清楚底層原因，我把編譯鏈接分開(kāi)了，下面這樣編譯也會(huì)報(bào)undefined reference錯(cuò)，其實(shí)底層原因與上面是一樣的。

1. gcc -o main main.c //缺少test()的實(shí)現(xiàn)文件 

需要改成如下形式才能成功，將test()函數(shù)的實(shí)現(xiàn)文件一起編譯。

1. gcc -o main main.c test.c //ok,沒(méi)問(wèn)題了 

2.    鏈接時(shí)缺少相關(guān)的庫(kù)文件（.a/.so）

    在此，只舉個(gè)靜態(tài)庫(kù)的例子，假設(shè)源碼如下。

    先把test.c編譯成靜態(tài)庫(kù)(.a)文件

1. gcc -c test.c  
2. ar -rc test.a test.o 

    至此，我們得到了test.a文件。我們開(kāi)始編譯main.c

1. gcc -c main.c 

    這時(shí)，則生成了main.o文件，然后我們?cè)偻ㄟ^(guò)如下命令進(jìn)行鏈接希望得到可執(zhí)行程序。

1. gcc -o main main.o 

    你會(huì)發(fā)現(xiàn)，編譯器報(bào)錯(cuò)了：

1. /tmp/ccCPA13l.o: In function `main':  
2. main.c:(.text+0x7): undefined reference to `test'  
3. collect2: ld returned 1 exit status 

    其根本原因也是找不到test()函數(shù)的實(shí)現(xiàn)文件，由于該test()函數(shù)的實(shí)現(xiàn)在test.a這個(gè)靜態(tài)庫(kù)中的，故在鏈接的時(shí)候需要在其后加入test.a這個(gè)庫(kù)，鏈接命令修改為如下形式即可。

1. gcc -o main main.o ./test.a  //注：./ 是給出了test.a的路徑 

     【擴(kuò)展】：同樣，為了把問(wèn)題說(shuō)清楚，上面我們把代碼的編譯鏈接分開(kāi)了，如果希望一次性生成可執(zhí)行程序，則可以對(duì)main.c和test.a執(zhí)行如下命令。

1. gcc -o main main.c ./test.a  //同樣，如果不加test.a也會(huì)報(bào)錯(cuò) 

3.    鏈接的庫(kù)文件中又使用了另一個(gè)庫(kù)文件

    這種問(wèn)題比較隱蔽，也是我最近遇到的與網(wǎng)上大家討論的不同的問(wèn)題，舉例說(shuō)明如下，首先，還是看看測(cè)試代碼。

    從上圖可以看出，main.c調(diào)用了test.c的函數(shù)，test.c中又調(diào)用了fun.c的函數(shù)。
    首先，我們先對(duì)fun.c，test.c，main.c進(jìn)行編譯，生成 .o文件。

1. gcc -c func.c  
2. gcc -c test.c  
3. gcc -c main.c 

    然后，將test.c和func.c各自打包成為靜態(tài)庫(kù)文件。

1. ar –rc func.a func.o  
2. ar –rc test.a test.o 

    這時(shí)，我們準(zhǔn)備將main.o鏈接為可執(zhí)行程序，由于我們的main.c中包含了對(duì)test()的調(diào)用，因此，應(yīng)該在鏈接時(shí)將test.a作為我們的庫(kù)文件，鏈接命令如下。

1. gcc -o main main.o test.a 

    這時(shí)，編譯器仍然會(huì)報(bào)錯(cuò)，如下：

1. test.a(test.o): In function `test':  
2. test.c:(.text+0x13): undefined reference to `func'  
3. collect2: ld returned 1 exit status 

    就是說(shuō)，鏈接的時(shí)候，發(fā)現(xiàn)我們的test.a調(diào)用了func()函數(shù)，找不到對(duì)應(yīng)的實(shí)現(xiàn)。由此我們發(fā)現(xiàn)，原來(lái)我們還需要將test.a所引用到的庫(kù)文件也加進(jìn)來(lái)才能成功鏈接，因此命令如下。

1. gcc -o main main.o test.a func.a 

    ok，這樣就可以成功得到最終的程序了。同樣，如果我們的庫(kù)或者程序中引用了第三方庫(kù)（如pthread.a）則同樣在鏈接的時(shí)候需要給出第三方庫(kù)的路徑和庫(kù)文件，否則就會(huì)得到undefined reference的錯(cuò)誤。

4 多個(gè)庫(kù)文件鏈接順序問(wèn)題

    這種問(wèn)題也非常的隱蔽，不仔細(xì)研究你可能會(huì)感到非常地莫名其妙。我們依然回到第3小節(jié)所討論的問(wèn)題中，在最后，如果我們把鏈接的庫(kù)的順序換一下，看看會(huì)發(fā)生什么結(jié)果？

1. gcc -o main main.o func.a test.a 

    我們會(huì)得到如下報(bào)錯(cuò).

1. test.a(test.o): In function `test':  
2. test.c:(.text+0x13): undefined reference to `func'  
3. collect2: ld returned 1 exit status 

    因此，我們需要注意，在鏈接命令中給出所依賴(lài)的庫(kù)時(shí)，需要注意庫(kù)之間的依賴(lài)順序，依賴(lài)其他庫(kù)的庫(kù)一定要放到被依賴(lài)庫(kù)的前面，這樣才能真正避免undefined reference的錯(cuò)誤，完成編譯鏈接。

5. 在c++代碼中鏈接c語(yǔ)言的庫(kù)

    如果你的庫(kù)文件由c代碼生成的，則在c++代碼中鏈接庫(kù)中的函數(shù)時(shí)，也會(huì)碰到undefined reference的問(wèn)題。下面舉例說(shuō)明。

    首先，編寫(xiě)c語(yǔ)言版庫(kù)文件： 

    編譯，打包為靜態(tài)庫(kù)：test.a

1. gcc -c test.c  
2. ar -rc test.a test.o 

    至此，我們得到了test.a文件。下面我們開(kāi)始編寫(xiě)c++文件main.cpp

    然后編譯main.cpp生成可執(zhí)行程序：

1. g++ -o main main.cpp test.a 

    會(huì)發(fā)現(xiàn)報(bào)錯(cuò)：

1. /tmp/ccJjiCoS.o: In function `main': 
2. main.cpp:(.text+0x7): undefined reference to `test()' 
3. collect2: ld returned 1 exit status 

    原因就是main.cpp為c++代碼，調(diào)用了c語(yǔ)言庫(kù)的函數(shù)，因此鏈接的時(shí)候找不到，解決方法：即在main.cpp中，把與c語(yǔ)言庫(kù)test.a相關(guān)的頭文件包含添加一個(gè)extern "C"的聲明即可。例如，修改后的main.cpp如下：

1. g++ -o main main.cpp test.a 

    再編譯會(huì)發(fā)現(xiàn)，問(wèn)題已經(jīng)成功解決。

6.  總 結(jié)

    當(dāng)然，上面幾種是我目前發(fā)現(xiàn)的比較常見(jiàn)的undefined reference錯(cuò)誤的原因和解決方法，可能也有其他各種原因，歡迎大家來(lái)信lujun.hust@gmail.com交流，對(duì)本文檔進(jìn)行補(bǔ)充，方面新手們解決學(xué)習(xí)過(guò)程中遇到的各種問(wèn)題。