零基础掌握Swift并发编程async await实战指南
大家好，我是一名开源项目的长期维护者，同时也在社区里担任iOS讲师，写过不少技术文档。在过去的教学和指导开源贡献者的过程中，我发现很多刚接触iOS开发的新手，在面对网络请求、数据加载等异步操作时，往往会被复杂的回调嵌套折磨得苦不堪言。
我当初学的时候，满屏幕的闭包嵌套让我一度怀疑自己是不是不适合写代码。为了解决这个痛点，Apple在Swift 5.5引入了革命性的async/await语法。今天，我就以讲师的视角，为大家写一篇完全零基础、新手友好的入门教程，带你轻松拿下Swift并发编程。
环境准备与工具链介绍
在开始写代码之前，我们需要准备好开发环境。请确保你的Mac上安装了最新版本的Xcode（建议Xcode 14或以上），因为async/await是较新版本的Swift才完整支持的特性。
在我们的实战项目中，前后端是需要配合的。后端团队使用 Springboot 框架为我们搭建了稳定高效的RESTful API接口。为了提高前端联调的效率，避免被后端接口进度阻塞，我推荐大家使用 Goose 这个开源工具来进行本地接口的Mock和并发压力测试。此外，在编写繁琐的单元测试和样板代码时，我还引入了 Devin 这个AI软件工程师助手，它能帮我们自动生成高质量的测试用例，大大节省了我们的开发时间。
准备好Xcode，新建一个iOS App项目，我们就可以正式开始了。
核心概念：用大白话理解异步并发
1. 什么是并发？
想象你是一个厨师（主线程），你要做一桌菜。
- 同步：你烧水，然后站在炉子前死死盯着水壶，水开了再切菜。这期间你什么都干不了，效率极低。
- 异步：你把水烧上，然后立刻去切菜。水开的过程中你做了其他事。这就是异步。
- 并发：你不仅烧水、切菜，还同时让另一个帮厨（子线程）去洗菜。大家协同工作，这就是并发。
2. 回调地狱的痛点
在async/await出现之前，我们处理异步通常使用闭包回调。
// 我当初学的时候，最怕看到这种代码
fetchUserData { user in
fetchUserPosts(user.id) { posts in
fetchPostComments(posts.first?.id) { comments in
// 终于拿到评论了，但代码已经缩进到了屏幕边缘！
}
}
}
这种代码不仅难以阅读，而且错误处理极其复杂，被称为“回调地狱”或“金字塔代码”。
3. async与await的魔法
async/await的本质是一种语法糖，它让异步代码写起来就像同步代码一样直观。
- async：标记一个函数是“异步”的，告诉编译器“这个函数可能会挂起等待”。
- await：在调用异步函数时使用，意思是“我在这里等一下，等它执行完再继续往下走，但不会阻塞当前线程”。
4. 传统回调 vs async/await 对比
| 对比维度 | 传统闭包回调 (Completion Handler) | async/await 现代并发 |
|---|---|---|
| 代码可读性 | 差，容易形成深层嵌套 | 极佳，线性执行，逻辑清晰 |
| 错误处理 | 复杂，需在每个闭包中处理Result或Error | 简单，统一使用do-catch块 |
| 返回值 | 无法直接return，只能通过闭包参数传出 | 可以直接使用return返回值 |
| 取消任务 | 极难实现，需要手动管理状态标志位 | 原生支持，通过Task.cancel()优雅取消 |
实战项目：开发一个用户信息加载器
接下来，我们跟着教程一步步完成一个简单的项目。我们要从后端（也就是前面提到的Springboot服务）获取用户信息，并加载用户的头像。
步骤一：定义数据模型
首先，我们需要定义与后端JSON对应的数据模型。Swift的Codable协议可以帮我们自动完成解析。
import Foundation
// 用户数据模型
struct UserProfile: Codable, Identifiable {
let id: Int
let name: String
let avatarURLString: String
// 计算属性，将字符串转为URL
var avatarURL: URL? {
URL(string: avatarURLString)
}
}
步骤二：编写异步网络请求
现在，我们来编写网络请求函数。注意函数名后面的async关键字，以及返回值的声明。
enum NetworkError: Error {
case invalidURL
case invalidResponse
}
class UserService {
// 1. 加上 async 关键字，表示这是一个异步函数
// 2. 加上 throws 表示可能会抛出错误
func fetchUserProfile() async throws -> UserProfile {
let urlString = "https://api.example.com/user/profile"
guard let url = URL(string: urlString) else {
throw NetworkError.invalidURL
}
// 使用 await 等待网络请求完成
// URLSession 的 data(from:) 方法本身就是 async 的
let (data, response) = try await URLSession.shared.data(from: url)
guard let httpResponse = response as? HTTPURLResponse,
httpResponse.statusCode == 200 else {
throw NetworkError.invalidResponse
}
// 解析JSON数据
let decoder = JSONDecoder()
let userProfile = try decoder.decode(UserProfile.self, from: data)
return userProfile
}
}
步骤三：在ViewModel中调用并更新UI
在iOS开发中，UI的更新必须在主线程进行。Swift引入了@MainActor来保证这一点。
import SwiftUI
@MainActor // 标记这个类的所有方法都在主线程执行
class UserViewModel: ObservableObject {
@Published var user: UserProfile?
@Published var errorMessage: String?
@Published var isLoading = false
private let userService = UserService()
// 加载用户数据的方法
func loadUserData() async {
isLoading = true
defer { isLoading = false } // 确保无论成功失败，都会将isLoading置为false
do {
// 使用 await 调用异步函数，代码看起来就像同步一样！
let fetchedUser = try await userService.fetchUserProfile()
self.user = fetchedUser
} catch {
self.errorMessage = "加载失败: \(error.localizedDescription)"
}
}
}
步骤四：在SwiftUI视图中触发任务
在SwiftUI中，我们可以使用.task修饰符来自动管理异步任务的生命周期。
struct UserProfileView: View {
@StateObject private var viewModel = UserViewModel()
var body: some View {
VStack {
if viewModel.isLoading {
ProgressView("加载中...")
} else if let user = viewModel.user {
Text("姓名: \(user.name)")
AsyncImage(url: user.avatarURL) { image in
image.resizable()
} placeholder: {
Color.gray
}
.frame(width: 100, height: 100)
.clipShape(Circle())
} else if let error = viewModel.errorMessage {
Text(error).foregroundColor(.red)
}
}
// .task 会在视图出现时自动启动任务，视图消失时自动取消任务
.task {
await viewModel.loadUserData()
}
}
}
步骤五：进阶实战 - 并发获取多个数据
假设我们不仅需要用户信息，还需要同时获取用户的“关注列表”和“粉丝列表”。使用async let可以让我们并发执行这些请求，而不是串行等待。
func fetchAllUserData() async throws -> (UserProfile, [String], [String]) {
// 使用 async let 开启并发子任务
async let profile = userService.fetchUserProfile()
async let following = userService.fetchFollowingList()
async let followers = userService.fetchFollowersList()
// 使用 await 等待所有结果返回
// 这三个请求是同时发出的，总耗时取决于最慢的那个请求
return try await (profile, following, followers)
}
常见问题与避坑指南
在我当初学的时候，以及后来教导新手的過程中，发现大家经常会踩以下几个坑。请务必仔细阅读。
1. 为什么我的UI没有更新，或者应用崩溃了？
原因：异步任务默认在后台线程执行。如果你在后台线程直接修改了@Published属性或更新了UI，就会导致崩溃或界面不刷新。
解决方案：如上文实战所示，在ViewModel类前面加上@MainActor注解。这相当于告诉编译器：“这个类里的所有代码，都必须乖乖回到主线程去执行。”
2. 页面退出了，网络请求还在跑怎么办？
原因：如果没有正确管理Task的生命周期，可能会导致内存泄漏或无效的网络请求。
解决方案：在SwiftUI中，尽量使用.task修饰符而不是.onAppear。.task会自动与视图的生命周期绑定，视图销毁时自动取消内部的await任务。如果在UIKit中，请保留Task对象的引用，并在viewDidDisappear时调用task.cancel()。
3. 编译器报紫：Call to main actor-isolated instance method...
原因：这是Swift并发中最常见的编译错误。意思是你在非主线程（或没有标记MainActor的上下文）中，调用了被@MainActor保护的方法。
解决方案：检查调用链。确保调用者也被标记为@MainActor，或者在调用时使用await MainActor.run { ... }将代码块显式派发到主线程。
学习建议与下一步路径
恭喜你！读到这里，你已经掌握了Swift async/await的核心用法，并且能够独立完成一个包含网络请求和UI更新的并发实战项目了。从“回调地狱”走向“线性代码”，这是iOS开发路上的一次巨大飞跃。
对于接下来的学习，我给大家几点建议：
- 深入理解Actor模型：
async/await解决了函数级别的异步，而Actor解决了数据竞争（Data Race）问题。下一步请务必学习什么是Actor，以及Sendable协议的作用。 - 掌握TaskGroup：当我们需要动态并发执行不确定数量的任务时（比如同时下载100张图片），
async let就不够用了，这时候需要学习withTaskGroup。 - 多阅读优秀开源代码：作为开源项目维护者，我强烈建议大家去GitHub上阅读一些优秀的Swift开源库（如 Alamofire 的新版本），看看大佬们是如何在实际工程中优雅地使用并发特性的。
编程是一场马拉松，不要指望看一篇文章就能成为高手。把今天教程里的代码亲手敲一遍，遇到报错不要怕，去分析编译器的提示。我当初也是一步步踩坑走过来的，相信只要你坚持实践，一定能写出优雅、高效的Swift代码。祝大家编码愉快！
评论 0