刚好做过类似的需求，给你整理一套完整的实现方案，分两部分讲清楚：

1. 基础：用自定义名称保存图片到本地 #

我们通常会把用户需要留存的图片存在应用的Documents目录里——这个目录是应用私有，不会被系统自动清理，而且iCloud备份默认会包含它（如果不需要备份可以配置排除）。

实现步骤：

• 将UIImage转换成可写入的Data（支持PNG或JPEG格式，JPEG可控制压缩质量）
• 构造自定义文件名（可以是用户指定名称、带时间戳的唯一名称，记得加上格式后缀）
• 获取Documents目录的URL，拼接文件名得到完整文件路径
• 将Data写入文件，做好错误处理（比如文件已存在、转换失败等情况）

Swift代码示例 #

func saveImageWithCustomName(image: UIImage, customName: String) throws {
    // 1. 转换图片为Data，这里用PNG格式；若用JPEG可替换为jpegData(compressionQuality: 0.8)
    guard let imageData = image.pngData() else {
        throw NSError(domain: "ImageSaveError", code: 1, userInfo: [NSLocalizedDescriptionKey: "无法将图片转换为可写入数据"])
    }
    
    // 2. 获取应用Documents目录的URL
    guard let documentsDirectory = FileManager.default.urls(for: .documentDirectory, in: .userDomainMask).first else {
        throw NSError(domain: "ImageSaveError", code: 2, userInfo: [NSLocalizedDescriptionKey: "无法获取Documents目录"])
    }
    
    // 3. 拼接自定义文件名（记得加上格式后缀）
    let fileURL = documentsDirectory.appendingPathComponent("\(customName).png")
    
    // 可选：避免覆盖已存在的文件，可先判断文件是否存在
    if FileManager.default.fileExists(atPath: fileURL.path) {
        throw NSError(domain: "ImageSaveError", code: 3, userInfo: [NSLocalizedDescriptionKey: "该名称的图片已存在"])
    }
    
    // 4. 写入文件
    try imageData.write(to: fileURL)
}

调用示例：

do {
    try saveImageWithCustomName(image: yourTargetImage, customName: "user_profile_avatar")
    print("图片保存成功")
} catch {
    print("保存失败：\(error.localizedDescription)")
}

2. 结合Image Picker Controller的完整流程（捕获+保存+检索） #

第一步：实现图片选择器代理，捕获选中的图片 #

首先确保你的ViewController遵守UIImagePickerControllerDelegate和UINavigationControllerDelegate，然后完成选择器的弹出与结果处理：

// 弹出图片选择器（从相册选，也可切换为.camera直接拍照）
func presentImagePicker() {
    let picker = UIImagePickerController()
    picker.sourceType = .photoLibrary
    picker.delegate = self
    present(picker, animated: true)
}

// 处理选中的图片
func imagePickerController(_ picker: UIImagePickerController, didFinishPickingMediaWithInfo info: [UIImagePickerController.InfoKey : Any]) {
    picker.dismiss(animated: true)
    
    // 获取原始图片（若需要编辑后的图片，可替换为.info.editedImage）
    guard let selectedImage = info[.originalImage] as? UIImage else {
        print("未能获取选中的图片")
        return
    }
    
    // 自定义文件名：这里用时间戳确保唯一性，也可以用用户输入的名称
    let customName = "selected_image_\(Date().timeIntervalSince1970)"
    do {
        try saveImageWithCustomName(image: selectedImage, customName: customName)
        print("图片已以名称「\(customName)」保存")
    } catch {
        print("保存失败：\(error.localizedDescription)")
    }
}

// 处理选择器取消事件
func imagePickerControllerDidCancel(_ picker: UIImagePickerController) {
    picker.dismiss(animated: true)
}

注意：如果使用相机功能，记得在Info.plist中添加NSCameraUsageDescription权限描述；访问相册则添加NSPhotoLibraryUsageDescription，否则应用会崩溃。

第二步：后续获取所有对应名称的图片 #

比如你想获取所有以selected_image_开头的图片，可以遍历Documents目录，筛选符合条件的文件并加载为UIImage：

func loadImagesWithPrefix(prefix: String) -> [UIImage] {
    var matchedImages = [UIImage]()
    guard let documentsDirectory = FileManager.default.urls(for: .documentDirectory, in: .userDomainMask).first else {
        return matchedImages
    }
    
    do {
        // 获取Documents目录下所有文件的URL
        let allFileURLs = try FileManager.default.contentsOfDirectory(at: documentsDirectory, includingPropertiesForKeys: nil)
        
        // 筛选文件名包含指定前缀的文件（注意带上格式后缀）
        let targetURLs = allFileURLs.filter { url in
            let fileName = url.lastPathComponent
            return fileName.hasPrefix("\(prefix).png")
        }
        
        // 将符合条件的文件转换为UIImage
        for url in targetURLs {
            if let imageData = try? Data(contentsOf: url), let image = UIImage(data: imageData) {
                matchedImages.append(image)
            }
        }
    } catch {
        print("加载匹配图片失败：\(error.localizedDescription)")
    }
    
    return matchedImages
}

调用示例：

let mySelectedImages = loadImagesWithPrefix(prefix: "selected_image_")
print("找到\(mySelectedImages.count)张匹配的图片")
// 可将这些图片展示在UICollectionView/UIImageView中

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