SwiftUI 性能审计

来源：摘自 @Dimillian 的 Dimillian/Skills（2025-12-31）。

概述

端到端审计 SwiftUI 视图性能，涵盖性能检测、基线建立、根因分析及具体修复措施。

工作流决策树

• 若用户提供代码，从“代码优先审查”开始。
• 若用户仅描述症状，先请求最小化代码/上下文，再执行“代码优先审查”。
• 若代码审查无法得出明确结论，则进入“引导用户进行性能分析”，并请求 trace 文件或截图。

1. 代码优先审查

需收集：

• 目标视图/功能的代码。
• 数据流：状态（state）、环境（environment）、可观察模型（observable models）。
• 具体症状与复现步骤。

重点关注：

• 因大范围状态变更引发的视图无效化风暴（view invalidation storms）。
• 列表中身份不稳定（id 频繁变更、每次渲染都调用 UUID()）。
• body 中执行高开销操作（如格式化、排序、图像解码）。
• 布局抖动（layout thrash）：深层视图栈、滥用 GeometryReader、偏好传递链（preference chains）。
• 未做下采样（downsampling）或缩放的大尺寸图像。
• 过度动画化的视图层级（在大型视图树上启用隐式动画）。

输出内容应包括：

• 附带代码引用的潜在根因分析。
• 建议的修复方案与重构方式。
• 必要时，提供最小可复现示例或检测建议（instrumentation suggestion）。

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

说明如何使用 Instruments 收集数据：

• 在 Instruments 中使用 SwiftUI 模板（需 Release 构建版本）。
• 精确复现问题交互（如滚动、导航、动画触发）。
• 捕获 SwiftUI 时间线（SwiftUI timeline）和时间剖析器（Time Profiler）。
• 导出或截取关键轨道（lanes）及调用树（call tree）。

需向用户索取：

• trace 导出文件，或 SwiftUI 轨道 + 时间剖析器调用树的截图。
• 设备型号 / iOS/macOS 版本 / 构建配置信息。

3. 分析与诊断

优先排查以下常见 SwiftUI 性能瓶颈：

• 因大范围状态变更引发的视图无效化风暴。
• 列表中身份不稳定（id 频繁变更、每次渲染都调用 UUID()）。
• body 中执行高开销操作（如格式化、排序、图像解码）。
• 布局抖动（深层视图栈、GeometryReader、偏好传递链）。
• 未做下采样或缩放的大尺寸图像。
• 过度动画化的视图层级（在大型视图树上启用隐式动画）。

结合 trace / 日志中的证据，汇总分析发现。

4. 修复措施

实施针对性修复：

• 缩小状态作用域：将 @State / @Observable 尽量靠近叶子视图。
• 稳定 ForEach 和列表项的身份标识（identity）。
• 将高开销操作移出 body（预计算、缓存、使用 @State 存储结果）。
• 对开销较大的子视图树，使用 equatable() 或自定义值包装器（value wrapper）优化更新。
• 渲染前对图像进行下采样（downsample）或缩放。
• 降低布局复杂度；在可行场景中采用固定尺寸（fixed sizing）。

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

代码审查过程中需留意以下模式。

body 中使用高开销格式化器

var body: some View {
    let number = NumberFormatter() // 分配开销大
    let measure = MeasurementFormatter() // 分配开销大
    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 } // 每次 body 计算均执行
}

推荐：预计算或在输入变更时缓存：

@State private var filtered: [Item] = []
// 当输入变更时更新 filtered

在 body 或 ForEach 中执行排序/过滤

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

推荐：在视图更新前一次性完成排序：

let sortedItems = items.sorted(by: sortRule)

在 ForEach 中内联过滤

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

推荐：使用已预过滤且身份稳定的集合。

身份不稳定

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

避免对非稳定值使用 id: .self；应使用稳定 ID。

主线程图像解码

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

推荐：在非主线程完成解码/下采样，并将结果缓存。

可观察模型中依赖范围过宽

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

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

推荐：采用更细粒度的视图模型（granular view models），或为每个项目维护独立状态，以减少更新扩散（update fan-out）。

5. 验证

请用户重新运行相同性能采集流程，并与原始基线指标对比。 如用户提供相关数据，需汇总差异（CPU 占用率、帧丢弃数、内存峰值等）。

输出内容

需提供：

• 简明指标对比表（如有“修复前/后”数据）。
• 按影响程度排序的首要问题清单。
• 拟议修复方案及对应预估工作量。

参考资料

根据用户提供的资料，在 references/ 目录下补充 Apple 官方文档与 WWDC 资源。

• 使用 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