這是個耗掉不少時間的低級錯誤,但症狀實在容易誤導人,值得記錄下來。
在一個類別中引用另一個類別的實例方法,編譯器給出警告:
instance method '-AddList:' not found (return type defaults to 'id')
奇怪的是,那個方法我確實寫了,標頭檔也宣告了,怎麼看都沒問題。
問題出在 import 的位置。我在實作檔(.m)中寫了:
#import "ExternalListLayer.h"
但在標頭檔(.h)裡,只用前向宣告帶過:
@class ExternalListLayer
@class 告訴編譯器「有這麼一個型別存在」,讓你能在介面中使用它的指標作為屬性或參數型別,但它不會引入該類別的成員宣告。因此當你在 .m 中對這個型別的物件送出 AddList: 訊息時,編譯器手上沒有任何方法簽名可比對,於是判定「找不到這個 method」,並貼心地(且誤導人地)補上一句「return type defaults to 'id'」。

為什麼當初會寫成 @class?這是 Objective-C 的常見優化手法:標頭檔之間盡量用前向宣告取代 import,可以打破不必要的相依關係、減少編譯時間,也避免循環引用。但在真正需要呼叫該類別方法的實作檔裡,就必須補上完整的 #import。


在需要呼叫方法的 .m 檔案頂端補上 #import "ExternalListLayer.h",警告立刻消失。
這個錯誤訊息其實有跡可循,記住兩個判斷點能省下不少時間:
第一,「return type defaults to 'id'」這句話是關鍵線索。它代表編譯器完全不知道你在呼叫什麼方法,而不是「方法簽名不匹配」。簽名不匹配的錯誤訊息長得完全不同(會列出期望的參數型別)。看到 defaults to 'id',先想是不是缺 import。
第二,確認該類別的宣告是以哪種形式出現。搜尋一下標頭檔,若只看到 @class 而沒有 #import 或 #include,答案就在那裡。
另外補充一個現代寫法上的注意事項:如果你的專案有用 modules(@import 或 Clang modules),這類問題的表現方式會略有不同,但根本原因一樣——編譯器需要看到完整介面才能驗證方法呼叫。
這個案例真正的代價不是找不到方法,而是「找不到方法」居然只是個警告,程式還能繼續編譯執行——直到執行到那行程式碼才出現莫名的行為。實務上建議在專案設定中把這類语意警告提升為錯誤(例如相應的 -Werror 設定或針對 Objective-C 方法宣告的嚴格檢查),讓問題在編譯階段就暴露,而不是等到除錯時才回頭找。