首先聲明
因為我是在真機上編譯的項目，所以報錯的架構（CPU指令集）為arm64。
- 如果我們使用64位模擬器（iPhone simulators 5s 或更高版本）編譯或者運行項目，就會報以下錯誤：
- Undefined symbols for architecture x86_64:
- 如果我們使用32位模擬器（iPhone simulators 5 或更低版本）編譯或者運行項目，就會報以下錯誤：
- Undefined symbols for architecture i386:
Undefined symbols for architecture XXX:類似的錯誤是一個開發中經常遇到的問題，凡是涉及到第三方靜態庫的項目，都不可避免的遇到過這一類錯誤。為了說明錯誤的原因和加深對解決方案的理解。筆者采用了故意復現問題的方式來驗證問題的解決方案：
即：故意給工程進行錯誤的配置或者刪除某些配置，使工程編譯不通過，然后記下編譯器報的錯誤，驗證什么情況下會報這種錯。
首先聲明，我的工程中引用（并非通過cocoapods引用）了友盟的統計SDK，名稱叫做libMobClickLibrary.a。存儲在工程的third_party目錄下，如下圖：
原因之一：沒有鏈接lib庫而報錯
lib是library的意思，lib庫就是指后綴名為.a的靜態庫。
(1) 刪除General -> Linked Frameworks and Libraries 下的libMobClickLibrary.a。如下圖分別是刪除前和刪除后的對比：
刪除前：
刪除后：
(2) 再次真機編譯項目，我們就能如愿以償的看到兩個經典的的錯誤 "OBJC_CLASS$_MobClick", referenced from: 和 linker command failed with exit code 1 (use -v to see invocation)，點擊第一個錯誤，如下圖：
（3）然后看到 Undefined symbols for architecture arm64：
但是我們怎么知道是沒有鏈接libMobClickLibrary.a庫而不是其他的什么庫呢？這還要取決于這句"_OBJC_CLASS_$_MobClick", referenced from:。其中_OBJC_CLASS_$_MobClick中的MobClick就是我們引用的libMobClickLibrary.a中的一個文件。因為我真的是在AliyunSalesCustomerListTableViewManager.m中通過#import "MobClick.h"引用了MobClick.h，如下圖：
當然，如果我們引用了libMobClickLibrary.a庫中的其他文件，那么OBJC_CLASS$_后面就不是MobClick了，這個大家應該是很好理解的。
有的時候，因為后面的類名跟第三方的庫名沒有任何相似處，比如庫名叫做libAAA.a，而報錯的類名卻是BBB。此時，我們通過后面的類名根本不能準確的判斷出這個BBB屬于哪個庫，也就不知道該鏈接哪個庫。這種情況下，我們可以通過referenced from:提示后面的文件名來判斷BBB到底屬于哪個靜態庫，因為我們自己的某個類文件不太可能import很多第三方的庫，這種情況下，采取這種方式比較好判斷。
總結：綜上，我們可知：項目中如果用到了某個第三方靜態庫，但lib靜態庫或者framework靜態庫沒有被鏈接時，就會遇到Undefined symbols for architecture XXX這一類的錯誤。
** 原因：**編譯項目時，因為靜態庫沒有鏈接進工程，所以靜態庫就不會參與編譯，而項目某些文件（.m文件）又引用（或者說依賴）了靜態庫，所以自然會報錯，而報的錯就是經典的 Undefined symbols for architecture XXX這一類的錯誤。
解決方案：下次遇到這類問題，我們只需要在Linked Frameworks and Libraries 中添加指定的靜態庫即可！
還原項目
因為剛才刪除了libMobClickLibrary.a文件，我們要想讓項目可以恢復到完美編譯運行的狀態，需要在Linked Frameworks and Libraries 添加libMobClickLibrary.a庫，如下圖：
因為是第三方庫，不是系統提供的庫，所以需要到我們自己的目錄中添加：如下圖展示了添加步驟：
至此，缺失的靜態庫已經被鏈接進工程中，再次編譯項目就不會報這個錯誤。當然，如果還報類似錯誤，說明你的項目中還需要鏈接其他的靜態庫，鏈接方法相同。
原因之二：沒有鏈接.framework靜態庫而報錯
上面說明了工程中因為缺少鏈接lib庫導致報錯的一種情況。iOS開發中有兩種格式的靜態庫（.a格式和.framework格式）。所以，我們也不難猜測：缺少鏈接.framework格式的靜態庫也會導致同樣的錯誤。
如果我們引用的第三方庫并不是.a格式的靜態庫，而是.framework格式的靜態庫，在Linked Frameworks and Libraries中沒有被鏈接的情況下，也會報同樣的錯誤。比如我在Linked Frameworks and Libraries 中刪除 PushCenterSDK.framework靜態庫(這個靜態庫存在于木紋中，不是cocoapods管理的)，如下圖:
（1）在Linked Frameworks and Libraries中刪除PushCenterSDK.framework
(2)模擬器編譯項目，出現以下三個錯誤：
（3）點擊第一個錯誤，查看錯誤詳情，如下圖：
發現：如果缺少鏈接.framework格式的靜態庫，也會報相同的錯誤，所以，不管我們缺少鏈接的是.a靜態庫還是.framework靜態庫，只要在Link Frameworks and Libraries 中沒有正確鏈接進去，都會報相同的錯誤，即：Undefined symbols for architecture XXX:。
值得注意的是，此處報了三個錯誤，原因在于，YunFuPushCenter.m文件中引用了PushCenterSDK.framework的兩個文件(如下圖)，所以會多報一個錯誤，這個是比較好理解的：
原因之三：extern引用不存在的全局變量而報錯
開發中，我們很有可能用到全局變量，比如在delegate.m文件中定義了一個int 型全局變量globalVar，在ViewController.m文件中通過extern int globalVar; 而引用A.m文件的這個全局變量。這樣是沒問題。但是如果我們不小心把extern int globalVar 寫成 extern int globalVariate，且在ViewController.m文件中使用了這個globalVariate變量（代碼如下）。
#import "AppDelegate.h"
@interface AppDelegate ()
@end
@implementation AppDelegate
int globalVar; // 生命一個全局變量
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
return YES;
}
#import "ViewController.h"
@interface ViewController ()
@end
@implementation ViewController
extern int globalVariate; // 引用一個不存在的全局變量
- (void)viewDidLoad {
[super viewDidLoad];
globalVariate = 10; // 給不存在的全局變量賦值
}
@end
編譯上面代碼也會報同樣的錯誤，如下圖：
點擊錯誤查看詳情，如下圖：
原因：因為extern int globalVariate并沒有定義名為globalVariate的變量，而是引用了一個名字叫做globalVariate的全局變量。當我們使用globalVariate時候，系統發現這個變量根本沒有定義，就會報這個錯誤。
原因之四：Compile Sources中沒有添加對應的.m文件而報錯
有時候，我們項目中并沒有以靜態庫的形式引用第三方庫，而是直接使用的三方源碼。也有可能出現相同的錯誤。如下圖：
項目中以源碼的形式引用了react native。某一次執行了git pull命令后，再編譯項目，就出現了下面這個錯誤。其意為：RCTSegmentedControlManager.m文件引用了RCTSegmentedControl文件，但是找不到RCTSegmentedControl.m這個文件（.h文件是不參與編譯的）。同理，RCTScrollView.m文件和RCTRefreshControlManager.m文件中引用了RCTRefreshControl.m文件，但是也找不到RCTRefreshControl.m文件。
于是乎，我們去Build Phases -> Compile Sources中搜索RCTRefreshControl或者RCTSegmentedControl，確實沒有找到對應的.m文件。如下圖1和圖2：
于是，把這兩個.m文件加進去，如下圖1和圖2：
最終，再次command + R，編譯通過！
綜上，如果某個.m文件沒有被添加在Compile Sources中，那么這個.m文件就不會參與編譯，導致其他文件引用該文件時，就會報錯: Undefined symbols for architecture XXX: 解決辦法，就是把這個.m文件添加到Compile Sources中。
文／VV木公子（簡書作者）
PS:如非特別說明，所有文章均為原創作品，著作權歸作者所有，轉載請聯系作者獲得授權，并注明出處，所有打賞均歸本人所有！
如果您是iOS開發者，或者對本篇文章感興趣，請關注本人，后續會更新更多相關文章！敬請期待！
