Objective-C Class Extension 與 Category 深度對比：私有介面、唯讀屬性與編譯器驗證

核心差異一覽

Class Extension 核心用途 1：私有介面與編譯器強制驗證

傳統做法：Private Category（無驗證）

// MyClass.h
@interface MyClass : NSObject
- (void)publicMethod;
@end

// MyClass.m (傳統)
@interface MyClass (Private)  // 命名 Category
- (void)awesomePrivateMethod;
@end

@implementation MyClass (Private)  // 獨立實現區塊
- (void)awesomePrivateMethod { ... }
@end

@implementation MyClass
- (void)publicMethod { ... }
@end

❌ 問題：編譯器認為 Private Category 方法在別處實現，不檢查是否真正實現。

現代做法：Class Extension（強制驗證）

// MyClass.m
@interface MyClass ()  // 匿名擴展
- (void)awesomePrivateMethod;
@property (nonatomic, strong) id privateData;
@end

@implementation MyClass
// 所有私有方法、屬性必須在這裡實現，否則編譯錯誤
- (void)awesomePrivateMethod { ... }
- (void)publicMethod { ... }
@end

✅ 優勢：編譯期保證所有宣告皆有實現，重構安全。

核心用途 2：公開唯讀、私有可寫屬性

// MyClass.h (公開介面)
@interface MyClass : NSObject
@property (nonatomic, readonly) float progress;  // 外部唯讀
@end

// MyClass.m (私有擴展)
@interface MyClass ()
@property (nonatomic, readwrite) float progress;  // 內部可寫
@end

@implementation MyClass
- (void)updateProgress:(float)p {
    _progress = p;  // 內部可直接賦值
    // 或 self.progress = p; (經由 setter)
}
@end

外部代碼：obj.progress ✅ 讀取；obj.progress = 0.5 ❌ 編譯錯誤。
內部代碼：_progress = 0.5 ✅ 或 self.progress = 0.5 ✅。

語法相似但語意不同：為什麼容易混淆？

// Category
@interface MyClass (Additions)
- (void)extraMethod;
@end

// Class Extension
@interface MyClass ()
- (void)privateMethod;
@end

關鍵區別：括號中是否有名稱。有名稱 = Category；空 = Extension。

進階：Extension 中添加實例變數 (現代 64-bit Runtime)

@interface MyClass ()
{
    NSString *_cachedDescription;  // 實例變數
    int _internalCounter;
}
@property (nonatomic, copy) NSString *cachedDescription;
@end

⚠️ 僅支援 64-bit macOS / iOS。32-bit 舊版 Runtime 不支援。

最佳實踐指南

常見誤區

1. 以為 Extension 就是匿名 Category → 語意、驗證、IVC 支援全不同
2. 在 .h 中寫 Extension → 洩露私有介面，違反封裝
3. Category 中重宣告屬性改特質 → 編譯器不阻擋但行為未定義
4. Extension 中聲明公開方法 → 應放在 .h 主介面