在含多图的UIDocument中处理图片加载存储：关联UIImage数组与文件

这问题我之前做本地文档存储项目时刚好碰到过，结合Codable和FileWrapper的特性，有两个很靠谱的方案，都能保证图片按原顺序还原，同时完美关联JSON元数据和图片文件：

方案一：自定义Codable逻辑，用文件名数组替代UIImage数组（推荐） #

核心思路是：编码时把[UIImage]?转换成唯一文件名数组存入JSON，同时把每个UIImage转成文件数据添加到FileWrapper；解码时根据JSON里的文件名数组，从FileWrapper中读取对应文件再转回UIImage，数组的顺序就由文件名数组的顺序来保证。

具体实现步骤： #

1. 给Location模型添加一个用于Codable的计算属性（不需要存储，仅用于编码解码）：

struct Location: Codable {
    // 你的文本属性
    let name: String
    let address: String
    
    // 实际存储的图片数组，不参与Codable
    var images: [UIImage]?
    
    // 用于Codable的文件名数组，仅在编码解码时使用
    private enum CodingKeys: String, CodingKey {
        case name, address, imageFileNames
    }
    private var imageFileNames: [String]? {
        get { images?.enumerated().map { "image_\($0.offset)_\(UUID().uuidString).png" } }
        set { /* 解码时用不到，这里可以留空 */ }
    }
}

2. 自定义Codable的编码解码逻辑，处理图片与FileWrapper的交互：

extension Location {
    // 编码：把图片写入FileWrapper，同时把文件名存入JSON
    func encode(to encoder: Encoder) throws {
        var container = encoder.container(keyedBy: CodingKeys.self)
        try container.encode(name, forKey: .name)
        try container.encode(address, forKey: .address)
        try container.encode(imageFileNames, forKey: .imageFileNames)
        
        // 处理图片写入FileWrapper（需要拿到外部的FileWrapper实例）
        guard let images = images, let fileNames = imageFileNames else { return }
        for (index, image) in images.enumerated() {
            guard let imageData = image.pngData() else {
                throw EncodingError.invalidValue(image, EncodingError.Context(codingPath: [], debugDescription: "无法将图片转换为PNG数据"))
            }
            let fileWrapper = FileWrapper(regularFileWithContents: imageData)
            encoder.userInfo[.fileWrapperKey]?[fileNames[index]] = fileWrapper
        }
    }
    
    // 解码：从FileWrapper读取图片，根据文件名数组还原顺序
    init(from decoder: Decoder) throws {
        let container = try decoder.container(keyedBy: CodingKeys.self)
        name = try container.decode(String.self, forKey: .name)
        address = try container.decode(String.self, forKey: .address)
        let fileNames = try container.decodeIfPresent([String].self, forKey: .imageFileNames)
        
        // 从FileWrapper读取图片
        guard let fileNames = fileNames, let fileWrapper = decoder.userInfo[.fileWrapperKey] as? FileWrapper, fileWrapper.isDirectory else {
            images = nil
            return
        }
        
        var decodedImages = [UIImage]()
        for fileName in fileNames {
            guard let imageFileWrapper = fileWrapper.fileWrappers?[fileName],
                  let imageData = imageFileWrapper.regularFileContents,
                  let image = UIImage(data: imageData) else {
                // 容错处理：跳过损坏或不存在的图片
                continue
            }
            decodedImages.append(image)
        }
        images = decodedImages.isEmpty ? nil : decodedImages
    }
}

// 自定义UserInfoKey用于传递FileWrapper
extension CodingUserInfoKey {
    static let fileWrapperKey = CodingUserInfoKey(rawValue: "fileWrapperKey")!
}

3. 使用时的注意事项：

• 编码前需要创建一个目录类型的FileWrapper，通过userInfo传递给编码器
• 解码时同样要把包含图片的FileWrapper通过userInfo传给解码器
• 文件名用UUID是为了避免重名，如果你需要更易读的命名，也可以用其他唯一标识，但要保证唯一性

方案二：利用FileWrapper的有序子项，按索引命名图片 #

如果不想在JSON里存储文件名数组，可以给图片按顺序命名（比如image_0.png、image_1.png...），编码时按索引生成文件名，解码时遍历所有以image_开头的文件，按数字索引排序后还原数组。

简化版示例： #

// 编码时
for (index, image) in images.enumerated() {
    let fileName = "image_\(index).png"
    // 写入FileWrapper逻辑同方案一
}

// 解码时
guard let fileWrappers = fileWrapper.fileWrappers else { return }
let imageFiles = fileWrappers.filter { $0.key.hasPrefix("image_") }
    .sorted {
        let index0 = Int($0.key.replacingOccurrences(of: "image_", with: "").replacingOccurrences(of: ".png", with: "")) ?? -1
        let index1 = Int($1.key.replacingOccurrences(of: "image_", with: "").replacingOccurrences(of: ".png", with: "")) ?? -1
        return index0 < index1
    }
// 遍历排序后的文件转成UIImage数组

这个方案更简单，但缺点是如果后续需要删除中间的图片，索引会出现断层，需要额外处理；而方案一的文件名数组能精准对应每个图片的位置，容错性更强。

关于你提到的“用URL替代数组”的疑问 #

其实不需要用URL，因为我们的图片是存在同一个FileWrapper里的，URL指向的是文件系统的绝对路径，一旦FileWrapper被移动或打包（比如存到iCloud Drive），路径就会失效。用文件名关联是更可靠的方式，因为FileWrapper的子文件是通过名称来索引的，和外部路径无关。

内容的提问来源于stack exchange，提问作者Maury Markowitz