名称： swiftui-性能审计
描述： 从代码审查和架构角度审计并改进 SwiftUI 运行时性能。用于诊断 SwiftUI 应用中的渲染缓慢、滚动卡顿、CPU/内存使用率高、视图更新过度或布局抖动等问题，并在仅靠代码审查不足时，为用户提供 Instruments 性能分析指导。

SwiftUI 性能审计

来源：复制自 @Dimillian 的 Dimillian/Skills (2025-12-31)。

概述

对 SwiftUI 视图性能进行端到端审计，涵盖性能测量与基线建立、根因分析以及具体的修复步骤。

工作流决策树

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

1. 代码优先审查

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

审查重点：
- 由广泛状态变更引起的视图失效风暴。
- 列表中不稳定的标识符（id 频繁变动，每次渲染都使用 UUID()）。
- 在 body 中执行繁重工作（格式化、排序、图片解码）。
- 布局抖动（深层嵌套的栈、GeometryReader、偏好链）。
- 未经降采样或调整大小的大图片。
- 过度动画的视图层次结构（在大规模视图树上使用隐式动画）。

提供：
- 可能的根本原因及代码引用。
- 建议的修复和重构方案。
- 如有需要，提供一个最小复现示例或性能测量建议。

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

解释如何使用 Instruments 收集数据：
- 在 Instruments 中使用 SwiftUI 模板（Release 构建）。
- 复现具体的交互操作（滚动、导航、动画）。
- 捕获 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() // 缓慢的分配操作
    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))
}

建议使用粒度更细的视图模型或每个项目的状态，以减少更新波及范围。

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