iOS数据持久化：NSKeyedArchiver与NSUserDefaults的模型对象存储实践

一、数据持久化基础概念

在iOS开发中，数据持久化是指将应用程序中的数据保存到设备存储中，使得应用关闭后数据不会丢失。系统提供了多种持久化方案，其中NSKeyedArchiver和NSUserDefaults是处理轻量级数据的常用方案。

核心区别：

• NSUserDefaults：设计用于存储简单数据类型（如NSString/NSNumber等）
• NSKeyedArchiver：专门用于归档复杂对象图（包括自定义模型对象）

二、NSKeyedArchiver存储模型对象详解

2.1 基本原理

NSKeyedArchiver是NSCoding协议的具体实现，采用对象归档(Archiving)机制将对象转换为二进制数据流。关键步骤包括：

1. 模型对象实现NSCoding协议

   class User: NSObject, NSCoding {
    var name: String
    var age: Int
    // 编码方法
    func encode(with coder: NSCoder) {
        coder.encode(name, forKey: "name")
        coder.encode(age, forKey: "age")
    }
    // 解码方法
    required init?(coder: NSCoder) {
        name = coder.decodeObject(forKey: "name") as? String ?? ""
        age = coder.decodeInteger(forKey: "age")
    }
   }

2. 归档与解档操作
   ```swift
   // 归档
   let user = User(name: “张三”, age: 25)
   let data = try? NSKeyedArchiver.archivedData(withRootObject: user, requiringSecureCoding: false)

// 存储到文件
let documents = FileManager.default.urls(for: .documentDirectory, in: .userDomainMask).first!
let archiveURL = documents.appendingPathComponent(“userData”)
try? data?.write(to: archiveURL)

// 解档
if let savedData = try? Data(contentsOf: archiveURL),
let loadedUser = try? NSKeyedUnarchiver.unarchiveTopLevelObjectWithData(savedData) as? User {
print(loadedUser.name) // 输出”张三”
}

### 2.2 技术优势
- 支持复杂对象图的序列化（对象包含对象）
- 保留对象间的引用关系
- 可自定义编码/解码逻辑
- 二进制格式存储效率高
## 三、NSUserDefaults存储对象方案
### 3.1 基础用法
虽然`NSUserDefaults`主要设计用于存储简单类型，但通过`NSKeyedArchiver`中转可实现对象存储：
```swift
// 存储对象
let user = User(name: "李四", age: 30)
let data = try? NSKeyedArchiver.archivedData(withRootObject: user, requiringSecureCoding: false)
UserDefaults.standard.set(data, forKey: "currentUser")
// 读取对象
if let savedData = UserDefaults.standard.data(forKey: "currentUser"),
   let loadedUser = try? NSKeyedUnarchiver.unarchiveTopLevelObjectWithData(savedData) as? User {
    print(loadedUser.age) // 输出30
}

3.2 使用限制

• 单次存储数据量不宜超过100KB
• 频繁读写可能影响性能
• 不适合存储敏感数据（未加密）

四、核心对比与选型建议

特性	NSKeyedArchiver	NSUserDefaults
存储类型	二进制文件	plist文件
数据容量	适合大体积数据	适合小体积数据
读写性能	读写较慢	读写更快
数据类型支持	支持自定义对象	仅支持Property List类型
典型应用场景	用户配置档案、游戏存档	应用设置、用户偏好

选型原则：

1. 需要存储自定义模型对象 → 必须使用NSKeyedArchiver
2. 简单配置项且数据量小 → 优先考虑NSUserDefaults
3. 大数据量或频繁读写 → 考虑CoreData/Realm等专业方案

五、高级实践技巧

5.1 版本兼容处理

当模型类新增属性时，需处理旧版本数据的兼容性：

required init?(coder: NSCoder) {
    // 新添加的属性提供默认值
    name = coder.decodeObject(forKey: "name") as? String ?? ""
    age = coder.decodeInteger(forKey: "age")
    // 新增属性（v2.0添加）
    email = coder.decodeObject(forKey: "email") as? String ?? ""
}

5.2 安全存储建议

1. 敏感数据应额外加密
2. 使用requiringSecureCoding参数防止任意类实例化
3. 实现NSSecureCoding协议提升安全性

六、常见问题解决方案

Q1 归档时出现”NSInvalidArgumentException”

• 检查所有属性是否都实现了编码/解码
• 确认所有嵌套对象也遵循NSCoding协议

Q2 读取NSUserDefaults返回nil

• 检查key拼写是否正确
• 确认数据类型匹配（dataForKey不是objectForKey）

Q3 跨版本数据迁移

• 实现版本检测逻辑
• 提供默认值处理缺失字段
• 考虑使用NSMigrationManager处理复杂迁移

七、替代方案展望

对于更复杂的数据持久化需求，开发者可以考虑：

• CoreData：提供对象图管理和查询能力
• Realm：跨平台高性能数据库
• SQLite.swift：轻量级SQLite封装

通过合理选择存储方案，可以显著提升应用的稳定性和用户体验。建议根据具体业务场景，在NSKeyedArchiver和NSUserDefaults之间做出明智选择。