SwiftUI 视图重构
概述
对 SwiftUI 视图应用一致的结构和依赖模式,重点关注顺序、模型-视图(MV)模式、谨慎的视图模型处理以及正确的 Observation 用法。
核心指南
1) 视图顺序(自上而下)
- 环境
private/publiclet@State/ 其他存储属性- 计算型
var(非视图) initbody- 计算型视图构建器 / 其他视图辅助方法
- 辅助 / 异步函数
2) 优先使用 MV(模型-视图)模式
- 默认采用 MV:视图是轻量级状态表达式;模型/服务拥有业务逻辑。
- 推崇使用
@State、@Environment、@Query以及task/onChange进行编排。 - 通过
@Environment注入服务和共享模型;保持视图小巧且可组合。 - 将大型视图拆分为子视图,而不是引入视图模型。
3) 拆分大型 body 和视图属性
- 如果
body超过一屏长度或包含多个逻辑区块,将其拆分为更小的子视图。 - 当大型计算视图属性(
var header: some View { ... })携带状态或复杂分支时,将其提取为专用的View类型。 - 将相关的子视图作为计算视图属性保留在同一文件中是可以的;仅在结构上有意义或为了复用时,才提取为独立的
View结构体。 - 优先传递小的输入(数据、绑定、回调),而不是复用整个父视图状态。
示例(提取一个区块):
var body: some View {
VStack(alignment: .leading, spacing: 16) {
HeaderSection(title: title, isPinned: isPinned)
DetailsSection(details: details)
ActionsSection(onSave: onSave, onCancel: onCancel)
}
}
示例(长 body → 更短的 body + 同一文件内计算视图):
var body: some View {
List {
header
filters
results
footer
}
}
private var header: some View {
VStack(alignment: .leading, spacing: 6) {
Text(title).font(.title2)
Text(subtitle).font(.subheadline)
}
}
private var filters: some View {
ScrollView(.horizontal, showsIndicators: false) {
HStack {
ForEach(filterOptions, id: \.self) { option in
FilterChip(option: option, isSelected: option == selectedFilter)
.onTapGesture { selectedFilter = option }
}
}
}
}
示例(提取复杂的计算视图):
private var header: some View {
HeaderSection(title: title, subtitle: subtitle, status: status)
}
private struct HeaderSection: View {
let title: String
let subtitle: String?
let status: Status
var body: some View {
VStack(alignment: .leading, spacing: 4) {
Text(title).font(.headline)
if let subtitle { Text(subtitle).font(.subheadline) }
StatusBadge(status: status)
}
}
}
4) 视图模型处理(仅在已存在的情况下)
- 除非请求或现有代码明确要求,否则不要引入视图模型。
- 如果视图模型已存在,尽可能使其非可选。
- 通过
init将依赖项传递给视图,然后在视图的init中将其传递给视图模型。 - 避免使用
bootstrapIfNeeded模式。
示例(基于 Observation):
@State private var viewModel: SomeViewModel
init(dependency: Dependency) {
_viewModel = State(initialValue: SomeViewModel(dependency: dependency))
}
5) Observation 用法
- 对于
@Observable引用类型,将其作为@State存储在根视图中。 - 根据需要显式传递可观测对象;除非必要,否则避免使用可选状态。
工作流程
- 按照排序规则重新排列视图。
- 优先使用 MV:使用
@State、@Environment、@Query、task和onChange将轻量级编排移入视图。 - 如果存在视图模型,用非可选的
@State视图模型替换可选的视图模型,并在init中通过传递来自视图的依赖项进行初始化。 - 确认 Observation 的使用:根
@Observable视图模型使用@State,没有冗余的包装器。 - 保持行为不变:除非被要求,否则不要更改布局或业务逻辑。
说明
- 优先使用小而明确的辅助方法,而非大型条件语句块。
- 将计算视图构建器放在
body下方,将非视图的计算变量放在init上方。 - 有关 MV 优先的指南和原理,请参阅
references/mv-patterns.md。
大型视图处理
- 当 SwiftUI 视图文件超过约 300 行时,使用扩展来分组相关的辅助方法。将异步函数和辅助函数移动到专用的
private扩展中,并用// MARK: -注释描述其用途(例如// MARK: - Actions、// MARK: - Subviews、// MARK: - Helpers)。保持主struct专注于存储属性、init 和body,当文件较长时,视图构建的计算变量也通过标记进行分组。