SwiftUI 视图重构
归属:从 @Dimillian 的 Dimillian/Skills 复制(2025-12-31)。
概述
为 SwiftUI 视图应用一致的结构和依赖模式,重点关注排序、Model-View (MV) 模式、谨慎的视图模型处理以及正确的 Observation 使用。
核心指南
1) 视图排序(从上到下)
- Environment
private/publiclet@State/ 其他存储属性- 计算
var(非视图) initbody- 计算的视图构建器 / 其他视图辅助函数
- 辅助 / 异步函数
2) 优先使用 MV (Model-View) 模式
- 默认使用 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将轻量级编排移入视图。 - 如果存在视图模型,则将可选的视图模型替换为在
init中通过从视图传递依赖项初始化的非可选@State视图模型。 - 确认 Observation 的使用:使用
@State作为根@Observable视图模型,没有冗余的包装器。 - 保持行为不变:除非要求,否则不更改布局或业务逻辑。
备注
- 首选小型、明确的辅助函数,而不是大型条件块。
- 将计算的视图构建器放在
body下方,将非视图的计算属性放在init上方。 - 有关 MV 优先的指南和原理,请参阅
references/mv-patterns.md。