Swift 圖片下載教學：使用 URLSession、SDWebImage 和 Kingfisher 的最佳實踐 🚀

在 Swift 中，下載圖片是一項常見任務，隨著技術的進步，實現這一操作的方法也越來越多樣化。本文將介紹如何使用 **2025 最新語法** 和最佳實踐，利用 **URLSession**、**SDWebImage** 和 **Kingfisher** 來快速下載圖片，並提供完整的實作範例，錯誤排除及延伸應用。

使用 URLSession 下載圖片

**URLSession** 是 Swift 中用於處理網絡請求的核心框架，適合用於下載圖片。以下是使用 URLSession 下載圖片的示例：

let imageURL = URL(string: "https://example.com/image.jpg")!

let task = URLSession.shared.dataTask(with: imageURL) { data, response, error in
    if let error = error {
        print("下載失敗：\(error.localizedDescription)")
        return
    }
    
    guard let data = data, let image = UIImage(data: data) else {
        print("無法獲取數據或轉換為圖片")
        return
    }
    
    DispatchQueue.main.async {
        // 將下載的圖片設置到 UIImageView
        imageView.image = image
    }
}

task.resume()

在這個示例中，我們處理了錯誤情況，並確保在主線程中更新 UI。

使用 SDWebImage 下載圖片

**SDWebImage** 是一個流行的第三方庫，提供了簡單的 API 來下載和緩存圖片。以下是使用 SDWebImage 的示例：

import SDWebImage

let imageURL = URL(string: "https://example.com/image.jpg")

imageView.sd_setImage(with: imageURL, placeholderImage: UIImage(named: "placeholder.png")) { (image, error, cacheType, url) in
    if let error = error {
        print("下載失敗：\(error.localizedDescription)")
    } else {
        print("圖片下載成功")
    }
}

在這個示例中，我們還添加了佔位圖片，並處理了圖片下載的回調。

使用 Kingfisher 下載圖片

**Kingfisher** 是另一個功能強大的圖片下載和緩存庫，使用起來也非常簡便。以下是 Kingfisher 的使用示例：

import Kingfisher

let imageURL = URL(string: "https://example.com/image.jpg")

imageView.kf.setImage(with: imageURL, placeholder: UIImage(named: "placeholder.png")) { result in
    switch result {
    case .success(let value):
        print("圖片下載成功：\(value.source.url?.absoluteString ?? "")")
    case .failure(let error):
        print("下載失敗：\(error.localizedDescription)")
    }
}

這裡同樣提供了下載成功和失敗的處理。

錯誤排除提示

在實作過程中，可能會遇到以下常見錯誤：

1. **圖片網址無效**：確保使用有效的圖片網址。
2. **無法獲取數據**：檢查網絡連接是否正常。
3. **UI 更新問題**：確保在主線程中更新 UIImageView。

延伸應用

除了基本的圖片下載，這些庫還提供了豐富的功能，如圖片緩存、GIF 支持和圖片處理等。你可以進一步探索這些功能來增強你的應用。

Q&A（常見問題解答）

Q1: 使用 URLSession 下載圖片時，如何處理網絡錯誤？

A1: 你可以在回調中檢查 error 參數，並根據需要進行錯誤處理，比如顯示提示信息。

Q2: SDWebImage 和 Kingfisher 有什麼區別？

A2: SDWebImage 和 Kingfisher 都是流行的圖片下載庫，但 Kingfisher 提供了更強大的圖片處理功能，而 SDWebImage 則簡單易用，適合快速實作。

Q3: 如何在下載圖片時顯示佔位圖？

A3: 在使用 SDWebImage 和 Kingfisher 時，你可以指定佔位圖片，當圖片正在下載或無法下載時顯示佔位圖。

—