凡是用到第三方靜態庫的項目,幾乎都撞過這行報錯:
Undefined symbols for architecture arm64: Undefined symbols for architecture x86_64: Undefined symbols for architecture i386:
其中架構名取決於你當前編譯的目標:真機是 arm64(armv7/armv7s 屬於更老的 32 位設備),64 位模擬器是 x86_64,老一點的 32 位模擬器是 i386。
為了把成因說清楚,筆者用「故意把工程改壞」的方式逐一復現了幾種場景。本文示例工程裡以非 CocoaPods 方式引入了友盟統計 SDK(libMobClickLibrary.a)和一個 PushCenterSDK.framework。

靜態庫目錄
所謂 lib 庫,就是後綴為 .a 的靜態庫。把 General → Linked Frameworks and Libraries 裡的 libMobClickLibrary.a 刪掉:
刪除前:

此時靜態庫正常鏈接
刪除後:

此時靜態庫不再被鏈接
重新編譯真機,就會看到兩個經典錯誤:
Undefined symbols for architecture arm64: "_OBJC_CLASS_$_MobClick", referenced from: ... ld: symbol(s) not found for architecture arm64 clang: error: linker command failed with exit code 1 (use -v to see invocation)

點開第一條錯誤查看詳情

Undefined symbols for architecture arm64
怎麼判斷缺的是哪個庫?關鍵在 _OBJC_CLASS_$_MobClick 這一段。MobClick 正是 libMobClickLibrary.a 裡的一個類,而我在 AliyunSalesCustomerListTableViewManager.m 中確實 #import 了 MobClick.h:

工程中引用了 MobClick.h
如果引用的是庫裡別的文件,那麼 $ 後面的類名自然也會跟著變。
有時候庫名和類名完全不搭,比如庫叫 libAAA.a,報錯的類卻是 BBB,這時可以借助 referenced from: 後面提示的源文件反推:某個 .m 文件通常不會 import 一大堆不相干的第三方庫,順著它找就八九不離十。
結論:項目用到了某個第三方靜態庫,但它沒有被添加到 Linked Frameworks and Libraries,編譯時該庫不參與鏈接,而代碼又依賴其中的符號,於是就報了 Undefined symbols for architecture XXX。解法就是把缺失的靜態庫補回鏈接列表。
因為是第三方庫而非系統庫,需要手動從本地目錄添加:

第一步:點擊「+」添加

第二步:選擇 Add Other

第三步:選中靜態庫並 Open
補回之後再次編譯,該錯誤消失。若仍報類似問題,說明還有別的庫沒鏈接,處理方式相同。
iOS 的靜態庫有兩種形態:.a 和 .framework。所以缺少 .framework 的鏈接,錯誤信息一模一樣。
把 PushCenterSDK.framework 從鏈接列表中刪除:

刪除 .framework 靜態庫
重新編譯:

因為缺少鏈接而報錯
查看詳情:

錯誤詳情
這裡之所以報了三條,是因為 YunFuPushCenter.m 中引用了 PushCenterSDK.framework 裡的兩個文件,每一個未解析符號各算一條:

引用了 framework 中的兩個文件
所以無論缺的是 .a 還是 .framework,只要沒在 Link Binary With Libraries 裡正確鏈接,都會得到同一條報錯。
這一類和靜態庫無關,純粹是代碼層面的筆誤。假設 AppDelegate.m 中定義了全局變量:
@implementation AppDelegate
int globalVar; // 定義一個全局變量
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
return YES;
}
@end
而在 ViewController.m 中引用時把名字打錯了:
@implementation ViewController
extern int globalVariate; // 引用一個不存在的全局變量
- (void)viewDidLoad {
[super viewDidLoad];
globalVariate = 10; // 給不存在的變量賦值
}
@end
編譯同樣會報 Undefined symbols:

查看詳情:

原因很直白:extern 只是聲明「這個變量在別處定義」,並不會真正開闢存儲。當全局範圍內找不到 globalVariate 的定義時,鏈接階段自然報未解析符號。把變量名拼對即可。
先看 referenced from: 提示的類與文件,判斷符號來源於哪個庫;
確認該庫是否出現在 Linked Frameworks and Libraries 中;
若庫已鏈接仍報錯,檢查 Search Path(Framework/ Library Search Paths)是否正確;
若與第三方庫無關,排查 extern 聲明、函數實現是否缺失、C/C++ 的 name mangling 是否匹配。