這篇是長期收藏、整理出來的一份錯誤清單,涵蓋 Xcode 開發過程中最高頻出現的十幾種狀況。遇到問題時可以直接搜尋對應編號。
先檢查程式碼中是否有 NSLog 印出了回傳 void 的表達式。這類語法錯誤會讓 clang 直接中斷。


把出錯的 PNG 用 PhotoShop 重新另存為 PNG-24 格式,通常就能解決。這個錯誤多半源自圖片本身的色彩設定或壓縮格式不被 Xcode 的 CopyPNGFile 工具接受。

確認靜態庫裡是否真的包含自訂的類別檔。若一個都沒有,就會出現相關警告——這也是為什麼 Xcode 建立靜態庫專案時會預附帶一個預設類別。
這代表某個類別沒有被編進最終產物。依序檢查兩處:


第一,確認該類別檔的 Target Membership 是否勾選了正確的 Project Target。


第二,確認 Build Phases 裡的 Compile Sources 是否已包含這個類別檔。兩步都檢查完仍然報錯,就把 Xcode 徹底關掉(包含背景程序)再重新編譯。


這個錯誤的意思是:指定的 framework 或靜態庫不支援 armv7s,因此無法在搭載 A6 晶片的 iPhone 5 上運行。各代指令集對應關係大致如下:
若是自己編譯第三方庫時遇到,通常是編譯設定造成的,把對應選項改為 NO 即可。


私有變數與屬性變數取了同一個名字所致,改掉其中一個即可。


類別方法(+ 開頭)中不能存取實例變數,因為類別方法沒有 instance 上下文。若確實需要,請改用類別變數或單例。


這類訊息通常表示某個屬性在目標類別中根本沒有宣告。手動補上即可:
@synthesize storyboard;
注意:Xcode 4.5 之後會對自訂類別自動合成,但系統類別不會,這點要特別小心。
這是 ARC 下的編譯器警告,因為編譯器無法靜態判斷 selector 的簽名。若確定安全,可以用 pragma 局部關閉:
#pragma clang diagnostic push #pragma clang diagnostic ignored "-Warc-performSelector-leaks" [self performSelector:nextView]; #pragma clang diagnostic pop
檢查同一個靜態庫或專案中是否存在兩個以上同名類別檔;接著刪除模擬器上的 App、清除 DerivedData 資料夾,重啟 Xcode。
屬性名稱不要用 new、copy 開頭,因為 ARC 會依 Cocoa 命名慣例推論所有權語意,造成衝突。
指定的靜態庫路徑找不到。檢查 Library Search Paths 與檔案實際位置是否一致。

加入 libicucore.dylib 即可,這是處理 Unicode 相關功能時常見的相依庫。
編譯器版本過低導致不認得 Objective-C 的字面語法。把編譯器切換到最新版本。


$(ARCHS_STANDARD) 或明確指定 armv7、armv7s。執行 ./configure 時加入 -D__ARM_ARCH_5TEJ__ 參數。
這通常表示同一個程序的另一個實例還在運行,或卡在了除錯器中。目前最有效的解法是重啟模擬器;若無效,連電腦一起重啟。日常習慣上,停止運行後再按停止鈕、不要直接卸載 App,可以大幅降低發生率。
這份清單會持續補充,歡迎提供你遇過的錯誤與解法。