這篇文章整理給初學者參考,把日常開發中最常撞到的編譯錯誤與警告集中說明,附上原因與解法。
意思是「xxx 尚未宣告(在此函式中第一次使用)」。使用某個變數前若還沒宣告,就會出現這個錯誤——Objective-C 與 C 都要求先宣告後使用。
新手常因為忘記宣告而遇到它,但熟練之後更常見的原因是變數名稱打錯,使用處與宣告處不一致。
- (void)test {
int count = 0;
return conut + 1; // count 被打成 conut
}
正確寫法:
- (void)test {
int count = 0;
return count + 1;
}
「在 xxx 之前發生語法解析錯誤」。這通常是低級失誤造成的,仔細看錯誤位置附近,多半能找到不符合語法的部分,最典型的就是漏打分號。
- (void)test {
NSString *str = @"This is test" // 漏了分號
NSLog(@"%@", str);
}
「關鍵字 #xxx 不正確」。當 #include、#import 等以 # 開頭的指令拼錯時會出現。在 Xcode 中,緊接 # 之後輸入的字串會變色,反而更容易誤打。
#improt <UIKit/UIKit.h> // #import 拼錯
「找不到名為 xxx.h 的檔案」。最常見的原因是檔名打錯,其次是檔案的搜尋路徑沒設定好。只要檔案確實被放進專案所屬的資料夾,一般都能被找到;若使用自行建立的子目錄,記得在 Build Settings 的 Header Search Paths 中補上。
#import "AppContrller.h" // 檔案其實叫 AppController.h
「符號 xxx 未被定義」。這個錯誤不只出現在編譯階段,連結階段也會發生——當你呼叫了一個根本不存在的類別或函式時就會看到它。
最常見的原因是函式名稱打錯:呼叫 C 函式時即使名稱有誤,編譯也能通過,但一到連結就會爆錯。另一個可能是使用了 Cocoa 以外的框架或函式庫,卻沒有把它加入專案——所有需要用到的 library 與 framework 都必須被 link 進來。
原因:Objective-C 不允許直接修改某個物件的結構體屬性的成員。_btn 是一個物件,而 frame 是 C 語言的結構體。物件可以同時定義屬性與方法,結構體只能有屬性,兩者本質不同,因此不能寫成 _btn.frame.origin.y -= 10; 這種形式。
解法一,先把結構體取出來,改完再整體賦回:
CGRect frame = _btn.frame;
frame.origin.y -= 10;
_btn.frame = frame;
解法二,只取出要改的分量,再用 CGRectMake 組回去:
CGFloat y = _btn.frame.origin.y;
y -= 10;
_btn.frame = CGRectMake(_btn.frame.origin.x, y,
_btn.frame.size.width, _btn.frame.size.height);
原因:id 型別不能使用點語法,因為編譯器無從得知它究竟是哪個類別。
解法一,改用 getter:
NSInteger i = [sender tag];
解法二,先轉型成實際的類別:
UIButton *button = (UIButton *)sender;
NSInteger i = button.tag;
這類錯誤通常是因為用底線前綴去存取了 @package 權限的成員。
被 @package 修飾的成員只能在同一個框架內部存取,跨框架使用會引發 link error。順便複習另外三種存取權限:@private 只能被宣告它的類別存取;@protected 可被宣告它的類別與其子類存取;@public 則任何類別都能存取。
原因:UITableViewController 需要一個 UITableView 作為根視圖,但你在 storyboard 中給它連的是一般 UIView。
解法:把 storyboard 中的那個 UIView 改成 UITableView,並重新連接 outlet。
原因:只有在 init 家族的方法中才能對 self 賦值。Xcode 判定 init 方法的規則是:回傳型別為 id(或 instancetype),且方法名以 init 加一個大寫字母開頭,例如 - (id)initWithXXX;。若你在其他方法中寫了 self = ...,就會看到這個錯誤。
警告中有必須修的,也有完全可以忽略的。但把警告清零總是比較舒服的,建議盡量處理。
「類別 xxx 中沒有 yyy 這個方法的宣告」。最常見的原因是方法名打錯:
NSString *str = [NSString stringWithForatm:@"%d", 10]; // 拼錯了
另一個原因是:在類別內部呼叫自己定義的方法時,如果該方法的實作寫在呼叫處之後,也會出現這個警告。這是因為編譯器是從檔案開頭順序往下檢查的。
有警告:
- (void)methodA {
[self methodB]; // methodB 定義在後面
}
- (void)methodB {}
無警告:
- (void)methodB {}
- (void)methodA {
[self methodB]; // 定義在前就不會警告
}
如果確實已在類別中實作該方法,這個警告可以忽略——編譯與連結都能通過,App 也能啟動;真正的方法檢查是在執行到該處時才進行的。
「變數 xxx 沒有被使用」。宣告了卻從未使用的變數會觸發它,通常是重構後殘留下來的宣告,直接刪掉即可。另外,宣告的名稱與使用的名稱不一致時也會出現這個警告。
- (void)test {
int a, b; // b 沒被用到
a = 5;
return a;
}
「區域變數 xxx 覆蓋了同名實例變數」。方法中的區域變數或參數若與實例變數同名,外部的實例變數就無法存取,此時應改掉其中一方的名稱。
@interface MyObject : NSObject {
int count;
}
@end
@implementation MyObject
- (void)updateCount:(int)count { } // 參數名與實例變數同名
@end
// 修正
- (void)updateCount:(int)num { }
「類別 xxx 的實作未完成,找不到方法 yyy 的定義」。在 .h 中宣告了方法卻沒在 .m 中實作,就會出現。補上實作,或把不再需要的方法從宣告中移除。若實作處的方法名與宣告不一致,也會觸發同樣的警告。
「非 void 型別的函式沒有設定回傳值」。回傳型別不是 void 的方法,務必回傳一個明確的值;若確實不需要回傳值,就把型別改成 void。反過來,宣告為 void 卻在方法裡 return 一個值,則會看到「'return' with a value, in function returning void」。
- (int)test:(int)count {
count++; // 沒有回傳值
}
// 修正
- (int)test:(int)count {
return count++;
}
「方法 xxx 的第 n 個參數型別與宣告不符」。例如宣告的是 NSEnumerator,傳進去的卻是 NSString。
最常見的原因是參數太多、順序填錯了,仔細核對即可。另一個常見情況是傳入 C 字串而非 NSString:
int value = 3;
NSString *str = [NSString stringWithFormat:"%d", value]; // 少了 @
// 修正
NSString *str = [NSString stringWithFormat:@"%d", value];
這個警告其實也可以反過來利用:想限制某個參數只能收特定類別時,就給它明確的型別;若任何物件都接受,才宣告為 id。參數型別本身就是設計者向呼叫者傳達的資訊。