SwiftUI 性能审计

来源：复制自 @Dimillian 的Dimillian/Skills(2025年12月31日).

概述

对 SwiftUI 视图性能进行端到端审计，涵盖从检测与基准测试到根因分析和具体修复步骤。

工作流程决策树

• 如果用户提供了代码，则从"代码优先审查"开始。
• 如果用户仅描述了症状，则请求最简代码/上下文，然后进行"代码优先审查"。
• 如果代码审查无法得出结论，则进入"引导用户进行性能分析"步骤，并请求性能追踪文件或截图。

1. 代码优先审查

收集：

• 目标视图/功能代码。
• 数据流：状态、环境、可观察模型。
• 症状和复现步骤。

重点关注：

• 因广泛的状态变化导致的视图失效风暴。
• 列表中不稳定的标识（id频繁变动，UUID()每次渲染）。
• 繁重的工作在主体（格式化、排序、图像解码）。
• 布局抖动（深层堆栈、GeometryReader、偏好链）。
• 未进行下采样或调整尺寸的大图像。
• 过度动画化的层级结构（大型树上的隐式动画）。

提供：

• 可能的根本原因及代码引用。
• 建议的修复和重构方案。
• 如果需要，提供一个最小化复现案例或检测建议。

2. 指导用户进行性能分析

解释如何使用 Instruments 收集数据：

• 在 Instruments 中使用 SwiftUI 模板（发布版本构建）。
• 复现确切的交互（滚动、导航、动画）。
• 捕获 SwiftUI 时间线和 Time Profiler。
• 导出或截图相关的时间线和调用树。

请求提供：

• SwiftUI 通道的跟踪导出文件或截图 + Time Profiler 调用树。
• 设备/操作系统/构建配置信息。

3. 分析与诊断

优先考虑可能的 SwiftUI 问题根源：

• 由广泛状态变更引起的视图失效风暴。
• 列表中不稳定的标识（id频繁变更，UUID()每次渲染都生成新值）。
• 在body中进行繁重工作（格式化、排序、图像解码）。
• 布局抖动（深层堆栈、GeometryReader、偏好链）。
• 未进行下采样或调整大小的大尺寸图像。
• 过度动画化的视图层级（大型视图树上使用隐式动画）。

根据跟踪/日志中的证据总结发现。

4. 修复

应用针对性修复：

• 缩小状态作用域（@State/@Observable更靠近叶子视图）。
• 稳定ForEach和列表的标识。
• 将繁重工作移出body（预先计算、缓存、@State）。
• 对开销大的子树使用equatable()或值包装器。
• 渲染前对图像进行降采样。
• 减少布局复杂度或在可能的情况下使用固定尺寸。

常见代码异味（及修复方法）

在代码审查时留意这些模式。

避免在body

var body: some View {
    let number = NumberFormatter() // slow allocation
    let measure = MeasurementFormatter() // slow allocation
    Text(measure.string(from: .init(value: meters, unit: .meters)))
}

中使用开销大的格式化器：优先在模型或专用辅助类中使用缓存的格式化器。

final class DistanceFormatter {
    static let shared = DistanceFormatter()
    let number = NumberFormatter()
    let measure = MeasurementFormatter()
}

计算属性执行繁重任务

var filtered: [Item] {
    items.filter { $0.isEnabled } // runs on every body eval
}

建议在变更时预先计算或缓存：

@State private var filtered: [Item] = []
// update filtered when inputs change

在主体或ForEach

List {
    ForEach(items.sorted(by: sortRule)) { item in
        Row(item)
    }
}

中进行排序/筛选

let sortedItems = items.sorted(by: sortRule)

建议在视图更新前一次性排序：在

ForEach(items.filter { $0.isEnabled }) { item in
    Row(item)
}

ForEach

中进行内联筛选

ForEach(items, id: \.self) { item in
    Row(item)
}

建议使用具有稳定标识的预筛选集合。不稳定标识避免

id: \.self

Image(uiImage: UIImage(data: data)!)

用于非稳定值；请使用稳定ID。

在主线程上解码图像

@Observable class Model {
    var items: [Item] = []
}

var body: some View {
    Row(isFavorite: model.items.contains(item))
}

建议在主线程外解码/下采样并存储结果。

可观察模型中的广泛依赖

建议使用细粒度视图模型或逐项状态以减少更新传播范围。

5. 验证

提供：

• 一个简短的指标表（如果可用，提供优化前/后的数据）。
• 按影响程度排序的主要问题。
• 提出的修复方案及预估工作量。

参考资料

将 Apple 官方文档和 WWDC 资源添加至references/ 目录下因为它们是用户提供的。

• 使用 Instruments 优化 SwiftUI 性能：references/optimizing-swiftui-performance-instruments.md
• 理解并改进 SwiftUI 性能：references/understanding-improving-swiftui-performance.md
• 理解应用中的卡顿：references/understanding-hangs-in-your-app.md
• 揭秘 SwiftUI 性能（WWDC23）：references/demystify-swiftui-performance-wwdc23.md