Objective-C KVC（鍵值編碼）核心機制與實戰指南

什麼是 KVC？

Key-Value Coding (KVC) 是 Objective-C 提供的一種間接存取物件屬性的機制：以字串為鍵，透過 valueForKey: 與 setValue:forKey: 訪問屬性，無需呼叫存取方法、無需直接操作實例變數。KVC 方法定義於 NSKeyValueCoding 非正式協定，預設實作由 NSObject 提供。

核心特性

• 支援物件指標、純量型別（int、float、BOOL 等）與結構體（CGRect、CGPoint 等），非物件型別會自動裝箱/拆箱（NSNumber、NSValue）。
• 鍵路徑支援 . 分隔符，可鏈式存取關聯物件屬性。
• 集合運算子（@sum、@avg、@max、@min、@count）可對陣列/集合執行聚合運算。

基本存取流程

呼叫 setValue:forKey: 或 valueForKey: 時，執行順序：

1. 尋找對應的 setter/getter（setKey:/key）。
2. 若無，檢查實例變數 _key 或 key。
3. 若仍無，拋出 NSUndefinedKeyException。

這意味著 KVC 可繞過公開介面，直接存取私有實例變數——雙刃劍，慎用。

程式碼實戰：基本設值與取值

Person *person = [[Person alloc] init];
NSMutableString *name = [[NSMutableString alloc] initWithString:@"張三"];

// 設值：自動尋找 setName: 或 _name 實例變數
[person setValue:name forKey:@"name"];

// 取值
NSLog(@"name : %@", [person valueForKey:@"name"]);

⚠️ 純量型別必須裝箱

// 錯誤：直接傳 int
[person setValue:25 forKey:@"age"]; // 崩潰或未定義行為

// 正確：包裝為 NSNumber
[person setValue:@(25) forKey:@"age"]; // 或 [NSNumber numberWithInt:25]

鍵路徑：穿透物件圖

Person *person = [[Person alloc] init];
Author *author = [[Author alloc] init];
[author setValue:@"iOS 開發" forKey:@"title"];
[person setValue:author forKey:@"author"];

// 單層存取
NSLog(@"name: %@", [person valueForKey:@"name"]);

// 鍵路徑穿透：person.author.title
NSString *title = [person valueForKeyPath:@"author.title"];
NSLog(@"title: %@", title);

一對多關係：集合自動映射

當對陣列發送 valueForKey: 時，KVC 會遍歷每個元素取其對應鍵值，並將結果打包成新陣列回傳：

NSMutableArray *persons = [NSMutableArray arrayWithCapacity:3];
for (int i = 0; i < 3; i++) {
    Person *p = [[Person alloc] init];
    [p setValue:[NSString stringWithFormat:@"person_%d", i] forKey:@"name"];
    [persons addObject:p];
}
[person setValue:persons forKey:@"rePerson"];

// 取得所有人的 name 陣列
NSArray *nameArray = [person valueForKeyPath:@"rePerson.name"];
NSLog(@"%@", nameArray); // 輸出: (person_0, person_1, person_2)

集合運算子：一行程式碼完成聚合

// 假設 rePerson 陣列中每個 Person 皆有 age 屬性
NSString *sum   = [person valueForKeyPath:@"rePerson.@sum.age"];   // 總和
NSString *count = [person valueForKeyPath:@"rePerson.@count.age"]; // 個數
NSString *max   = [person valueForKeyPath:@"rePerson.@max.age"];   // 最大值
NSString *min   = [person valueForKeyPath:@"rePerson.@min.age"];   // 最小值
NSString *avg   = [person valueForKeyPath:@"rePerson.@avg.age"];   // 平均值

NSLog(@"sum=%@ count=%@ max=%@ min=%@ avg=%@", sum, count, max, min, avg);

最佳實踐與避坑指南

總結

KVC 是 Objective-C 動態特性的核心體現，支援鍵路徑穿透、集合映射與聚合運算，極大簡化資料綁定、序列化、表單驗證等場景程式碼。掌握其存取順序、裝箱規則與集合運算子，能讓你在需要動態性時游刃有餘，同時避免濫用帶來的維護風險。