SwiftUI 模式 是做什么的？
适用于 Apple 平台的现代 SwiftUI 模式，用于构建声明式、高性能的用户界面。涵盖 Observation 框架、视图组合、类型安全导航和性能优化。
何时激活
- 构建 SwiftUI 视图和管理状态 (
@State,@Observable,@Binding) - 使用
NavigationStack设计导航流程 - 构建视图模型和数据流
- 优化列表和复杂布局的渲染性能
- 在 SwiftUI 中处理环境值和依赖注入
状态管理
属性包装器选择
选择最适合的简单包装器：
| 包装器 | 使用场景 |
|---|---|
@State | 视图本地的值类型（开关、表单字段、Sheet 呈现） |
@Binding | 对父视图 @State 的双向引用 |
@Observable 类 + @State | 拥有多个属性的模型 |
@Observable 类（无包装器） | 从父视图传递的只读引用 |
@Bindable | 对 @Observable 属性的双向绑定 |
@Environment | 通过 .environment() 注入的共享依赖 |
@Observable ViewModel
使用 @Observable（而不是 ObservableObject）——它跟踪属性级别的更改，因此 SwiftUI 仅重新渲染读取了更改属性的视图：
@Observable
final class ItemListViewModel {
private(set) var items: [Item] = []
private(set) var isLoading = false
var searchText = ""
private let repository: any ItemRepository
init(repository: any ItemRepository = DefaultItemRepository()) {
self.repository = repository
}
func load() async {
isLoading = true
defer { isLoading = false }
items = (try? await repository.fetchAll()) ?? []
}
}
使用 ViewModel 的视图
struct ItemListView: View {
@State private var viewModel: ItemListViewModel
init(viewModel: ItemListViewModel = ItemListViewModel()) {
_viewModel = State(initialValue: viewModel)
}
var body: some View {
List(viewModel.items) { item in
ItemRow(item: item)
}
.searchable(text: $viewModel.searchText)
.overlay { if viewModel.isLoading { ProgressView() } }
.task { await viewModel.load() }
}
}
环境注入
用 @Environment 替换 @EnvironmentObject：
// 注入
ContentView()
.environment(authManager)
// 消费
struct ProfileView: View {
@Environment(AuthManager.self) private var auth
var body: some View {
Text(auth.currentUser?.name ?? "Guest")
}
}
视图组合
提取子视图以限制失效范围
将视图分解为小型、专注的结构体。当状态更改时，只有读取该状态的子视图会重新渲染：
struct OrderView: View {
@State private var viewModel = OrderViewModel()
var body: some View {
VStack {
OrderHeader(title: viewModel.title)
OrderItemList(items: viewModel.items)
OrderTotal(total: viewModel.total)
}
}
}
用于可复用样式的 ViewModifier
struct CardModifier: ViewModifier {
func body(content: Content) -> some View {
content
.padding()
.background(.regularMaterial)
.clipShape(RoundedRectangle(cornerRadius: 12))
}
}
extension View {
func cardStyle() -> some View {
modifier(CardModifier())
}
}
导航
类型安全的 NavigationStack
使用带有 NavigationPath 的 NavigationStack 进行编程式、类型安全的路由：
@Observable
final class Router {
var path = NavigationPath()
func navigate(to destination: Destination) {
path.append(destination)
}
func popToRoot() {
path = NavigationPath()
}
}
enum Destination: Hashable {
case detail(Item.ID)
case settings
case profile(User.ID)
}
struct RootView: View {
@State private var router = Router()
var body: some View {
NavigationStack(path: $router.path) {
HomeView()
.navigationDestination(for: Destination.self) { dest in
switch dest {
case .detail(let id): ItemDetailView(itemID: id)
case .settings: SettingsView()
case .profile(let id): ProfileView(userID: id)
}
}
}
.environment(router)
}
}
性能
对大型集合使用惰性容器
LazyVStack 和 LazyHStack 仅在视图可见时创建：
ScrollView {
LazyVStack(spacing: 8) {
ForEach(items) { item in
ItemRow(item: item)
}
}
}
稳定标识符
始终在 ForEach 中使用稳定、唯一的 ID——避免使用数组索引：
// 使用 Identifiable 协议或显式指定 id
ForEach(items, id: \.stableID) { item in
ItemRow(item: item)
}
避免在 body 中进行昂贵操作
- 切勿在
body内部执行 I/O、网络调用或繁重的计算 - 使用
.task {}进行异步工作——当视图消失时它会自动取消 - 在滚动视图中谨慎使用
.sensoryFeedback()和.geometryGroup() - 尽量减少列表中的
.shadow()、.blur()和.mask()——它们会触发离屏渲染
Equatable 协议一致性
对于包含昂贵 body 的视图，遵循 Equatable 协议以跳过不必要的重新渲染：
struct ExpensiveChartView: View, Equatable {
let dataPoints: [DataPoint] // DataPoint 必须遵循 Equatable
static func == (lhs: Self, rhs: Self) -> Bool {
lhs.dataPoints == rhs.dataPoints
}
var body: some View {
// 复杂的图表渲染
}
}
预览
使用带有内联模拟数据的 #Preview 宏进行快速迭代：
#Preview("空状态") {
ItemListView(viewModel: ItemListViewModel(repository: EmptyMockRepository()))
}
#Preview("已加载") {
ItemListView(viewModel: ItemListViewModel(repository: PopulatedMockRepository()))
}
应避免的反模式
- 在新代码中使用
ObservableObject/@Published/@StateObject/@EnvironmentObject—— 迁移到@Observable - 将异步工作直接放在
body或init中 —— 使用.task {}或显式加载方法 - 在不拥有数据的子视图中将 ViewModel 创建为
@State—— 改成从父视图传递 - 使用
AnyView类型擦除 —— 对于条件视图，优先使用@ViewBuilder或Group - 在向/从 actor 传递数据时忽略
Sendable要求
参考
有关基于 actor 的持久化模式，请参考技能：swift-actor-persistence
有关基于协议的依赖注入和 Swift Testing 测试，请参考技能：swift-protocol-di-testing