KVO 是 Key-Value Observing 的縮寫,中文稱作「鍵值觀察」。它是 iOS 提供的一種通知機制,用來解決一個常見問題:當某個 model 的資料改變時,界面要同步更新,但我們並不知道資料何時會變,总不能開個迴圈一直輪詢。
傳統做法是發通知(Notification),而 KVO 是另一種更輕巧的方式。它的實作機制是:為可能改變的資料掛上一個觀察者(通常就是 controller),一旦資料發生變化,觀察者就會收到信號,進而取得變化內容並執行自己的邏輯。

界面上有兩個 label,分別顯示姓名與分數;還有一個按鈕用來修改分數。點擊按鈕後分數變化,label 內容跟著更新。
直接在按鈕的響應方法裡改 label 文字当然也行,但這裡我們改用 KVO 來完成,以便完整走一遍流程。
整理一下需要完成的工作:
新建一個 NSObject 子類作為學生模型,含姓名與分數兩個屬性:
// StudentModel.h @interface StudentModel : NSObject @property (nonatomic, copy) NSString *name; @property float score; @end // ViewController.m // 在 controller 中實例化學生模型 self.studentModel = [[StudentModel alloc] init]; [self.studentModel setValue:@"Cloudox" forKey:@"name"]; [self.studentModel setValue:@"89.0" forKey:@"score"];
這裡刻意用 setValue:forKey: 的方式賦值,因為 KVO 觀察的是「key」,而屬性名稱正好對應 key、屬性值對應 value——兩者是一套東西。
真正開始使用 KVO 至少要實作兩個方法:
addObserver:forKeyPath:options:context: observeValueForKeyPath:ofObject:change:context:
第一個用來註冊觀察者,四個參數分別是:
[self.studentModel addObserver:self
forKeyPath:@"score"
options:NSKeyValueObservingOptionNew
context:nil];在按鈕的響應方法中,同樣以 setValue:forKey: 更新分數。
// KVO 回呼
- (void)observeValueForKeyPath:(NSString *)keyPath
ofObject:(id)object
change:(NSDictionary<NSKeyValueChangeKey, id> *)change
context:(void *)context {
if ([keyPath isEqualToString:@"score"]) {
self.scoreLabel.text = [NSString stringWithFormat:@"Score:%@",
[self.studentModel valueForKey:@"score"]];
}
}回呼方法的四個參數正好對應註冊時的四個參數。透過 keyPath 判斷是不是自己想接收的變化,就能對不同被觀察者做不同處理。這裡確認是分數變化後,就用新的分數更新 label。
[self.studentModel removeObserver:self forKeyPath:@"score"];
通常在 dealloc 或 viewController 銷毀時移除。未移除就釋放被觀察者,是 KVO 最常見的崩潰來源。
註冊時可以透過 context 塞入任意內容,回呼時再取出:
// 註冊時傳遞內容
[self.studentModel addObserver:self
forKeyPath:@"score"
options:NSKeyValueObservingOptionNew
context:"heyMe"];
// 回呼時取得
- (void)observeValueForKeyPath:(NSString *)keyPath
ofObject:(id)object
change:(NSDictionary<NSKeyValueChangeKey, id> *)change
context:(void *)context {
if ([keyPath isEqualToString:@"score"]) {
self.scoreLabel.text = [NSString stringWithFormat:@"Score:%@",
[self.studentModel valueForKey:@"score"]];
}
NSLog(@"%@", context); // 印出 heyMe
}options 與回呼中的 change 參數是一對,用來決定 change 裡能拿到什麼:
addObserver 回傳前就先發出一次通知。Setting = 1(setter 被呼叫)、Insertion = 2、Removal = 3、Replacement = 4(後三者發生在觀察集合型資料時)。這些值都可以印到 console 實際看一下,會比看文件直觀得多。
預設是自動通知:只要值改變就會通知觀察者。若你希望「只在特定條件下才通知」,就得改成手動模式。第一步是在被觀察的模型中覆寫類別方法:
// StudentModel.m
+ (BOOL)automaticallyNotifiesObserversForKey:(NSString *)key {
BOOL automatic = NO;
if ([key isEqualToString:@"score"]) {
automatic = NO;
} else {
automatic = [super automaticallyNotifiesObserversForKey:key];
}
return automatic;
}這裡把 score 的自動通知關閉,其餘情況仍交由父類判斷,寫法比較保險。
改成手動之後,需要自己在前後包上 will/did change:
// 按鈕響應
- (void)changeScore {
[self.studentModel willChangeValueForKey:@"score"];
[self.studentModel setValue:@"99.0" forKey:@"score"];
[self.studentModel didChangeValueForKey:@"score"];
}若一次操作會改動多個屬性,通知可以嵌套:
- (void)changeScore {
[self.studentModel willChangeValueForKey:@"name"];
[self.studentModel willChangeValueForKey:@"score"];
[self.studentModel setValue:@"Cloud" forKey:@"name"];
[self.studentModel setValue:@"99.0" forKey:@"score"];
[self.studentModel didChangeValueForKey:@"score"];
[self.studentModel didChangeValueForKey:@"name"];
}而在集合這類一對多关系中,除了 key,還必須告知「變化的類型」與「索引」:
- (void)removeTransactionsAtIndexes:(NSIndexSet *)indexes {
[self willChange:NSKeyValueChangeRemoval
valuesAtIndexes:indexes
forKey:@"transactions"];
// 移除指定索引位置的交易物件
[self didChange:NSKeyValueChangeRemoval
valuesAtIndexes:indexes
forKey:@"transactions"];
}還有一個重要議題是 keyPathDependenciesForClass,也就是鍵值依賴:當某個屬性的值取決於物件中的其他屬性時,可以宣告這層依賴關係,讓那些屬性改變時自動通知依賴它的屬性。這部分的細節值得再深入研究與實作驗證。
示例工程:https://github.com/Cloudox/KVODemo
最後提醒:KVO 屬性觀察在現代 Swift 開發中多已改用 Observable、Combine 或 @Observable 等宣告式方案;但在 Objective-C 與 Cocoa 框架(例如 AVPlayer、NSOperation 狀態)中,KVO 仍然是無法迴避的基礎知識。