SwiftUI 效能審計
概述
端到端審計 SwiftUI 視圖效能,從儀器化和基準設定,到根本原因分析和具體的修復步驟。
工作流程決策樹
- 如果使用者提供了程式碼,從「程式碼優先審查」開始。
- 如果使用者只描述了症狀,要求提供最小程式碼或上下文,然後進行「程式碼優先審查」。
- 如果程式碼審查無法得出結論,則轉到「引導使用者進行剖析」,並要求提供追蹤記錄或螢幕截圖。
1. 程式碼優先審查
收集:
- 目標視圖/功能程式碼。
- 資料流:狀態、環境、可觀察模型。
- 症狀與重現步驟。
重點關注:
- 因廣泛狀態變更導致的視圖失效風暴。
- 列表中不穩定的身份識別(
id變動、每次渲染時UUID())。 - 在
body中執行重量級工作(格式化、排序、圖片解碼)。 - 佈局震盪(深層堆疊、
GeometryReader、偏好鏈)。 - 未經縮放或調整大小的過大圖像。
- 過度動畫化的層級結構(大型視圖樹上的隱含動畫)。
提供:
- 可能的根本原因及其對應的程式碼參考。
- 建議的修復方法和重構方案。
- 必要時,提供最小重現範例或儀器化建議。
2. 引導使用者進行剖析
解釋如何使用 Instruments 收集數據:
- 在 Instruments 中使用 SwiftUI 模板(Release 建置)。
- 重現確切的互動操作(滾動、導航、動畫)。
- 擷取 SwiftUI 時間軸和時間分析器。
- 匯出或截取相關的通道和呼叫樹。
要求提供:
- 追蹤記錄匯出或 SwiftUI 通道及時間分析器呼叫樹的螢幕截圖。
- 設備/作業系統/建置配置。
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