Communitygithub.com

ComeOnOliver/skillshub

当 UI 响应缓慢、滚动卡顿、动画掉帧,或询问“为什么我的 SwiftUI 视图加载慢”、“如何优化 List 性能”、“我的应用掉帧”、“视图 body 被频繁调用”、“列表卡顿”时使用——基于 Instruments 26 和 WWDC 2025 模式的 SwiftUI 性能优化。

skillshub 是什么?

该技能专注于使用 Apple 最新的性能分析工具(Instruments 26 及 WWDC 2025 中引入的模式)诊断并优化 SwiftUI 应用的性能。它系统性地解决两大核心问题:视图 body 更新耗时过长以及不必要的视图更新。技能涵盖了如何利用全新的 SwiftUI 仪器(该仪器包含可视化时间长轴、因果图以及与 Time Profiler 的集成)来定位瓶颈。它详细介绍了 iOS 26 框架的自动性能改进,例如列表加载速度提升 6 倍、滚动时掉帧减少以及惰性堆栈的嵌套滚动视图优化。此外,该技能提供了实用的优化策略,包括通过缓存昂贵的格式化程序来加速视图 body、使用 `@Sendable` 优化检查清单,以及通过 Identity 排查来避免不必要的视图重建。最终,开发者能够掌握一套系统的决策流程,从而优先处理性能优化任务,并利用新的分析工具做出权衡决策,确保 SwiftUI 应用运行流畅。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ComeOnOliver/skillshub/tree/HEAD/skills/CharlesWiltgen/Axiom/axiom-swiftui-performance

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

SwiftUI 性能优化

何时使用此技能

在以下情况下使用:

  • 应用响应迟钝(出现卡顿、挂起、滚动延迟)
  • 动画在执行过程中暂停或跳跃
  • 滚动性能差
  • 性能剖析显示 SwiftUI 是瓶颈
  • 视图 body 执行时间过长
  • 视图更新频率超出必要
  • 需要理解 SwiftUI 更新的因果关系

示例提示

这些是开发者经常提出、本技能旨在解答的真实问题:

1. “我的应用滚动卡顿,动画不流畅。如何判断是否是 SwiftUI 导致的?”

→ 该技能将演示如何使用 Instruments 26 中全新的 SwiftUI Instrument 来确定瓶颈是否来自 SwiftUI 或其他层级。

2. “我使用了新的 SwiftUI Instrument,看到了表示长时间更新的橙色/红色条。如何知道是什么原因导致的?”

→ 该技能涵盖了因果图模式,该模式可以显示数据在应用中的流向,以及哪些状态更改触发了昂贵的更新。

3. “有些视图更新过于频繁,即使它们的数据没有更改。如何找出是哪些视图有问题?”

→ 该技能演示了不必要的更新检测以及使用可视化时间轴进行 Identity 问题排查。

4. “我有大型数据结构和复杂的视图层次结构。如何为 SwiftUI 性能优化它们?”

→ 该技能涵盖了性能模式:分解视图层次结构、最小化 body 复杂度,以及使用 @Sendable 优化检查清单。

5. “我们有一个性能截止日期,需要了解 SwiftUI 中哪些部分慢。关键指标是什么?”

→ 该技能提供了用于优先处理优化工作的决策树,并理解压力场景,同时提供关于权衡的专业指导。


概述

核心原则:确保你的视图 body 快速更新且仅在必要时更新,以实现出色的 SwiftUI 性能。

WWDC 2025 新特性:Instruments 26 中的新一代 SwiftUI Instrument 提供了全面的性能分析,包括:

  • 长时间更新的可视化时间轴(根据严重程度用橙色/红色编码)
  • 显示应用中数据流的因果图
  • 与 Time Profiler 集成,用于 CPU 分析
  • 挂起和卡顿跟踪

关键性能问题:

  1. 视图 body 更新耗时过长 — 视图 body 属性执行时间过长
  2. 不必要的视图更新 — 数据实际上未更改时视图仍然更新

iOS 26 框架性能改进

“对框架的性能改进使苹果所有平台上的应用受益,从我们的应用到你的应用。” — WWDC 2025-256

iOS 26 中的 SwiftUI 包含了重大的性能提升,所有应用都能自动受益。这些改进与新的性能分析工具一起,使 SwiftUI 开箱即用就能更快。

List 性能(macOS 重点)

大型列表的巨大改进

  • macOS 上包含 100,000 个以上项目的列表加载速度提升 6 倍
  • 大型列表更新速度提升 16 倍
  • 更大的列表受益更大
  • 改进使 所有平台 受益(iOS、iPadOS、watchOS,而不仅仅是 macOS)
List(trips) { trip in // 10万+ 个项目
    TripRow(trip: trip)
}
// iOS 26: macOS 上加载速度提升 6 倍,更新速度提升 16 倍
// 所有平台都受益于性能改进

对你应用的影响

  • 大数据集(1万+ 个项目)能感受到明显改进
  • 过滤和排序操作完成得更快
  • 列表的实时更新响应更迅速
  • 文件浏览器、联系人列表、数据表格等应用受益

滚动性能

高速滚动时掉帧减少

SwiftUI 改进了 iOS 和 macOS 上用户界面更新的调度。这提高了响应速度,并让 SwiftUI 能做更多工作来准备即将到来的帧。总而言之,这降低了应用在高帧率下快速滚动时掉帧的可能性。

关键改进

  1. 更好的帧调度 — SwiftUI 有更多时间为即将到来的帧做准备
  2. 改进的响应速度 — UI 更新调度更有效率
  3. 更少的掉帧 — 尤其是在 120Hz(ProMotion)下快速滚动时

何时会注意到

  • 滚动包含大量图片的内容时
  • 使用高帧率设备(iPhone Pro、配备 ProMotion 的 iPad Pro)时
  • 列表行包含多个视图时

嵌套滚动视图与惰性堆栈

图片轮播和多轴滚动现在能正确优化

ScrollView(.horizontal) {
    LazyHStack {
        ForEach(photoSets) { photoSet in
            ScrollView(.vertical) {
                LazyVStack {
                    ForEach(photoSet.photos) { photo in
                        PhotoView(photo: photo)
                    }
                }
            }
        }
    }
}
// iOS 26: 嵌套滚动视图现在能正确延迟加载惰性堆栈内容
// 非常适合图片轮播、Netflix 风格布局、多轴内容

在 iOS 26 之前 嵌套的 ScrollView 没有正确延迟加载惰性堆栈内容,导致所有嵌套内容立即加载。

在 iOS 26 之后 嵌套在 ScrollView 中的惰性堆栈现在会延迟加载,直到内容即将显示,与单层 ScrollView 的行为匹配。

使用场景

  • 支持水平和垂直滚动的图片库
  • Netflix 风格分类行
  • 多维数据浏览器
  • 带有垂直详细滚动功能的图片轮播

SwiftUI 性能 Instrument 增强

Instruments 26 中的新通道

SwiftUI Instrument 现在包含专用的通道:

  1. 长时间视图 body 更新 — 识别昂贵的 body 计算
  2. 平台视图更新 — 跟踪 UIKit/AppKit 桥接性能(长时间 Representable 更新)
  3. 其他长时间更新 — 所有其他类型的长时间 SwiftUI 工作

这些通道将在下一节中详细介绍。

性能改进总结

自动获得的改进(仅需重新编译)

  • ✅ 列表加载速度提升 6 倍(10万+ 个项目,macOS)
  • ✅ 列表更新速度提升 16 倍(macOS)
  • ✅ 滚动时掉帧减少
  • ✅ iOS/macOS 上帧调度改进
  • ✅ 嵌套 ScrollView 惰性加载优化

无需更改代码 — 使用 iOS 26 SDK 重新构建即可获得这些改进。

交叉参考 SwiftUI 26 特性(swiftui-26-ref 技能)— 所有 iOS 26 SwiftUI 更改的全面指南


SwiftUI Instrument (Instruments 26)

入门

要求:

  • 安装 Xcode 26
  • 将设备更新到最新的操作系统版本(支持录制 SwiftUI 跟踪)
  • 以 Release 模式构建应用以获得准确的性能分析

启动:

  1. 在 Xcode 中打开项目
  2. 按 Command-I 进行性能分析
  3. 从模板选择器中选择 SwiftUI 模板
  4. 点击录制按钮

模板内容

SwiftUI 模板包含三个 Instrument:

  1. SwiftUI Instrument(全新)— 识别 SwiftUI 代码中的性能问题
  2. Time Profiler — 显示随时间变化的 CPU 工作样本
  3. Hangs and Hitches — 跟踪应用响应能力

SwiftUI Instrument 轨道通道

通道 1:更新组

  • 显示 SwiftUI 何时在积极工作
  • CPU 峰值期间为空? → 问题可能不在 SwiftUI 内部

通道 2:长时间视图 body 更新

  • 高亮显示 body 属性耗时过长的情况
  • 最常见的性能问题 — 从此处开始

通道 3:长时间 Representable 更新

  • 识别缓慢的 UIViewRepresentable/NSViewRepresentable 更新
  • UIKit/AppKit 集成性能

通道 4:其他长时间更新

  • 所有其他类型的长时间 SwiftUI 工作

颜色编码系统

更新根据导致卡顿的可能性以 橙色 和 红色 显示:

  • 红色 — 极有可能导致卡顿/挂起(优先调查)
  • 橙色 — 中等可能性导致问题
  • 灰色 — 正常更新,无需关注

注意:更新是否实际导致卡顿取决于设备条件,但红色更新是最高优先级。


理解渲染循环

正常帧渲染

帧 1:
├─ 处理事件(触摸、按键)
├─ 更新 UI(运行视图 body)
│  └─ 在帧截止时间前完成 ✅
├─ 移交给系统
└─ 系统渲染 → 在屏幕上显示

帧 2:
├─ 处理事件
├─ 更新 UI
│  └─ 在帧截止时间前完成 ✅
├─ 移交给系统
└─ 系统渲染 → 在屏幕上显示

结果:流畅、细腻的动画

导致卡顿的帧(长时间视图 body)

帧 1:
├─ 处理事件
├─ 更新 UI
│  └─ 一个视图 body 太慢
│  └─ 运行超过帧截止时间 ❌
├─ 错过截止时间
└─ 上一帧保持可见(卡顿)

帧 2:(延迟)
├─ 处理事件(延迟 1 帧)
├─ 更新 UI
├─ 移交给系统
└─ 系统渲染 → 最终显示

结果:上一帧可见超过 2 帧 = 动画卡顿

导致卡顿的帧(更新过多)

帧 1:
├─ 处理事件
├─ 更新 UI
│  ├─ 更新 1(快速)
│  ├─ 更新 2(快速)
│  ├─ 更新 3(快速)
│  ├─ ...(100 次更多快速更新)
│  └─ 总时间超过截止时间 ❌
├─ 错过截止时间
└─ 上一帧保持可见(卡顿)

结果:许多小更新累积起来导致错过截止时间

关键洞察:视图 body 运行时间之所以重要,是因为错过帧截止时间会导致卡顿,从而使动画流畅度降低。

参考:


问题 1:长时间视图 body 更新

识别长时间更新

  1. 使用 SwiftUI 模板在 Instruments 中 记录跟踪
  2. 查看 长时间视图 body 更新通道 — 是否有橙色/红色条?
  3. 展开 SwiftUI 轨道 查看子轨道
  4. 选择 视图 body 更新子轨道
  5. 过滤出长时间更新:
    • 详情窗格 → 下拉菜单 → 选择 "长时间视图 body 更新摘要"

使用 Time Profiler 分析

工作流程:

  1. 在长时间视图 body 更新摘要中找到长时间更新
  2. 悬停在视图名称上 → 点击箭头 → "显示更新"
  3. 右键点击长时间更新 → "设置检查范围并缩放"
  4. 切换到 Time Profiler Instrument 轨道

你将会看到:

  • 视图 body 执行期间记录的样本的调用堆栈
  • 每帧花费的时间(最左列)
  • 嵌套在深层 SwiftUI 调用堆栈中的视图 body

寻找瓶颈:

  1. 按住 Option 键点击以展开主线程调用堆栈
  2. 使用 Command-F 搜索你的视图名称(例如 "LandmarkListItemView")
  3. 在时间列中识别昂贵的操作

常见的昂贵操作

格式化程序创建(非常昂贵)

❌ 错误 - 在视图 body 中创建格式化程序:

struct LandmarkListItemView: View {
    let landmark: Landmark
    @State private var userLocation: CLLocation

    var distance: String {
        // ❌ 每次 body 运行时都创建格式化程序
        let numberFormatter = NumberFormatter()
        numberFormatter.maximumFractionDigits = 1

        let measurementFormatter = MeasurementFormatter()
        measurementFormatter.numberFormatter = numberFormatter

        let meters = userLocation.distance(from: landmark.location)
        let measurement = Measurement(value: meters, unit: UnitLength.meters)
        return measurementFormatter.string(from: measurement)
    }

    var body: some View {
        HStack {
            Text(landmark.name)
            Text(distance) // 调用昂贵的 distance 属性
        }
    }
}

为什么慢:

  • 格式化程序创建成本高昂(每次数毫秒)
  • 每次视图 body 运行时都创建
  • 在主线程上运行 → 应用在继续 UI 更新之前必须等待
  • 多个视图 → 时间迅速累积

✅ 正确 - 集中缓存格式化程序:

@Observable
class LocationFinder {
    private let formatter: MeasurementFormatter
    private let landmarks: [Landmark]
    private var distanceCache: [Landmark.ID: String] = [:]

    init(landmarks: [Landmark]) {
        self.landmarks = landmarks

        // 在初始化期间创建格式化程序一次
        let numberFormatter = NumberFormatter()
        numberFormatter.maximumFractionDigits = 1

        self.formatter = MeasurementFormatter()
        self.formatter.numberFormatter = numberFormatter

        updateDistances()
    }

    func didUpdateLocations(_ locations: [CLLocation]) {
        guard let location = locations.last else { return }
        updateDistances(from: location)
    }

    private func updateDistances(from location: CLLocation? = nil) {
        guard let location else { return }

        for landmark in landmarks {
            let meters = location.distance(from: landmark.location)
            let measurement = Measurement(value: meters, unit: UnitLength.meters)
            distanceCache[landmark.id] = formatter.string(from: measurement)
        }
    }

    func distanceString(for landmarkID: Landmark.ID) -> String {
        distanceCache[landmarkID] ?? "未知"
    }
}

struct LandmarkListItemView: View {
    let landmark: Landmark
    @Environment(LocationFinder.self) private var locationFinder

    var body: some View {
        HStack {
            Text(landmark.name)
            Text(locationFinder.distanceString(for: landmark.id)) // ✅ 快速查找
        }
    }
}

好处:

  • 格式化程序创建一次,为所有地标重用
  • 位置更改时预计算字符串
  • 视图 body 仅读取缓存值(即时)
  • 长时间的视图 body 更新被消除

其他昂贵操作

复杂计算:

// ❌ 不要在视图 body 中计算
var body: some View {
    let result = expensiveAlgorithm(data) // 复杂数学、排序等
    Text("\(result)")
}

// ✅ 在模型中计算,缓存结果
@Observable
class ViewModel {
    private(set) var result: Int = 0

    func updateData(_ data: [Int]) {
        result = expensiveAlgorithm(data) // 计算一次
    }
}

网络/文件 I/O:

// ❌ 切勿在视图 body 中进行 I/O 操作
var body: some View {
    let data = try? Data(contentsOf: fileURL) // ❌ 同步 I/O
    // ...
}

// ✅ 异步加载

...

[内容已截断以供翻译]

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

ComeOnOliver/skillshub

Create stunning, animation-rich HTML presentations from scratch or by converting PowerPoint files. Use when the user wants to build a presentation, convert a PPT/PPTX to web, or create slides for a talk/pitch. Helps non-designers discover their aesthetic through visual exploration rather than abstract choices.

ComeOnOliver/skillshub

Next.js 16+ 和 Turbopack — 增量打包、文件系统缓存、开发速度,以及何时使用 Turbopack 与 webpack。

ComeOnOliver/skillshub

SwiftUI architecture patterns, state management with @Observable, view composition, navigation, performance optimization, and modern iOS/macOS UI best practices.

ComeOnOliver/skillshub

See, Understand, Act on video and audio. See- ingest from local files, URLs, RTSP/live feeds, or live record desktop; return realtime context and playable stream links. Understand- extract frames, build visual/semantic/temporal indexes, and search moments with timestamps and auto-clips. Act- transcode and normalize (codec, fps, resolution, aspect ratio), perform timeline edits (subtitles, text/image overlays, branding, audio overlays, dubbing, translation), generate media assets (image, audio, video), and create real time alerts for events from live streams or desktop capture.

ComeOnOliver/skillshub

AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.

ComeOnOliver/skillshub

Next.js 15 애플리케이션을 위한 프론트엔드 개발 가이드라인. React 19, TypeScript, Shadcn/ui, Tailwind CSS를 사용한 모던 패턴. Server Components, Client Components, App Router, 파일 구조, Shadcn/ui 컴포넌트, 성능 최적화, TypeScript 모범 사례 포함. 컴포넌트, 페이지, 기능 생성, 데이터 페칭, 스타일링, 라우팅, 프론트엔드 코드 작업 시 사용.

ComeOnOliver/skillshub

Provides Tamagui patterns for config v4, compiler optimization, styled context, and cross-platform styling. Must use when working with Tamagui projects (tamagui.config.ts, @tamagui imports).

ComeOnOliver/skillshub

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.

ComeOnOliver/skillshub

Create high-converting, visually distinctive landing pages. Use when building marketing pages, product launches, SaaS homepages, or any single-page conversion-focused website. Guides section-by-section composition with anti-AI-slop principles.

ComeOnOliver/skillshub

Auto-loaded context for Portfolio Buddy 2 development. Use for ANY task involving: React 19 development, TypeScript, portfolio analysis features, metrics calculations, trading strategy comparison, or working with the Portfolio Buddy 2 codebase. Contains tech stack, known issues, and architectural constraints.

ComeOnOliver/skillshub

Next.js development tooling via MCP. Inspect routes, components, build info, and debug Next.js apps. Use when working on Next.js applications, debugging routing, or inspecting app structure. NOT for general React or non-Next.js projects.

ComeOnOliver/skillshub

Implement UI using Shadcn MCP (atoms/theme) and 21st.dev MCP (complex sections). Use when adding buttons, layouts, or generating landing pages.

ComeOnOliver/skillshub

A conceptual skill for building an API client in Next.js that handles JWT tokens

ComeOnOliver/skillshub

Best practices and patterns for Next.js App Router, Server Actions, and Routing in this project.

ComeOnOliver/skillshub

The Design System, Theme, and UX rules for the Physical AI Hub.

ComeOnOliver/skillshub

Comprehensive frontend development skill for building modern, performant web applications using ReactJS, NextJS, TypeScript, Tailwind CSS. Includes component scaffolding, performance optimization, bundle analysis, and UI best practices. Use when developing frontend features, optimizing performance, implementing UI/UX designs, managing state, or reviewing frontend code.

ComeOnOliver/skillshub

This document captures learnings from fixing keyboard navigation issues when floating components (Select, DropdownMenu, Popover) have CSS open/close animations.

ComeOnOliver/skillshub

Build Next.js 16 applications with correct patterns and distinctive design. Use when creating pages, layouts, dynamic routes, upgrading from Next.js 15, or implementing proxy.ts. Covers breaking changes (async params/searchParams, Turbopack, cacheComponents) and frontend aesthetics. NOT when building non-React or backend-only applications.

ComeOnOliver/skillshub

Comprehensive Framer Motion animation library for React. Covers motion components, variants, gestures, page transitions, and scroll animations. Use when adding animations to React/Next.js applications.

ComeOnOliver/skillshub

Build interfaces that resonate, not just render. This skill enforces bold, intentional

相关技能