Swift（iOS/macOS）HTTP 客户端：2024 年顶级库

Swift (iOS/macOS) 的 HTTP 客户端：网络请求顶级库

网络操作是 iOS 和 macOS 开发中不可或缺的一部分。无论是从 REST API 加载数据、发送文件还是使用 WebSocket，选择合适的 HTTP 客户端直接影响性能、代码可读性和开发时间。本文将介绍 Swift 的四大顶级库，帮助您高效处理 HTTP 请求。

1. URLSession — Apple 内置标准框架

URLSession 是 Apple 用于网络请求的基础框架。它内置于每个 iOS/macOS 应用中，无需安装额外依赖。支持 HTTP/2、后台下载、身份验证和缓存。

优点：

• 无需外部依赖
• 与 GCD 和 Combine (async/await) 完全集成
• 原生实现带来高性能
• 支持后台会话用于文件下载

缺点：

• 复杂场景需要大量 boilerplate 代码
• 缺少便捷的序列化/反序列化 API

使用示例 (Swift 5.5+ 配合 async/await)：

import Foundation

struct User: Codable {    let id: Int    let name: String    let email: String}

func fetchUser(id: Int) async throws -> User {    let url = URL(string: "https://jsonplaceholder.typicode.com/users/\\(id)")!    let (data, response) = try await URLSession.shared.data(from: url)        guard let httpResponse = response as? HTTPURLResponse,          (200...299).contains(httpResponse.statusCode) else {        throw URLError(.badServerResponse)    }        return try JSONDecoder().decode(User.self, from: data)}

// 使用Task {    do {        let user = try await fetchUser(id: 1)        print("User: \\(user.name), email: \\(user.email)")    } catch {        print("Error: \\(error.localizedDescription)")    }}

2. Alamofire — 最流行的 Swift HTTP 客户端

Alamofire 是 URLSession 的优雅封装，能显著简化网络请求。该库提供链式 API、自动 JSON 序列化、错误处理、文件上传/下载以及 Combine 支持。

优点：

• 最少的 boilerplate 代码
• 内置错误处理和重试机制
• 支持 Codable、Combine 和 async/await
• 灵活配置请求头、参数和超时

缺点：

• 额外依赖（约 1-2 MB）
• 对简单项目可能过于臃肿

使用示例：

import Alamofire

struct Post: Codable {    let userId: Int    let id: Int    let title: String    let body: String}

// GET 请求配合 async/awaitfunc fetchPosts() async throws -> [Post] {    let response = await AF.request("https://jsonplaceholder.typicode.com/posts")        .serializingDecodable([Post].self)        .response        switch response.result {    case .success(let posts):        return posts    case .failure(let error):        throw error    }}

// POST 请求带参数func createPost(title: String, body: String) async throws -> Post {    let parameters: Parameters = [        "userId": 1,        "title": title,        "body": body    ]        let response = await AF.request("https://jsonplaceholder.typicode.com/posts",                                    method: .post,                                    parameters: parameters,                                    encoding: JSONEncoding.default)        .serializingDecodable(Post.self)        .response        switch response.result {    case .s