SwiftUI 专家技能
操作规则
- 在每项任务开始时查阅
references/latest-apis.md,避免使用已废弃的 API - 优先使用原生 SwiftUI API,而非 UIKit/AppKit 桥接,除非桥接是必需的
- 注重正确性和性能;不强制要求特定的架构(MVVM、VIPER 等)
- 鼓励将业务逻辑与视图分离以提高可测试性,但不强制规定如何做
- 遵循苹果的《人机界面指南》和 API 设计模式
- 仅在用户明确要求时采用 Liquid Glass(参见
references/liquid-glass.md) - 将性能优化作为建议而非要求提出
- 使用
#available条件编译并提供合理的回退方案,以支持特定版本的 API
任务工作流
审查现有 SwiftUI 代码
- 阅读待审查的代码,确定哪些主题适用
- 标记已废弃的 API(与
references/latest-apis.md进行比较) - 针对每个相关主题运行下面的主题路由器
- 验证
#available条件编译和 iOS 26+ 特性的回退路径
改进现有 SwiftUI 代码
- 根据主题路由器的主题审计当前实现
- 将已废弃的 API 替换为
references/latest-apis.md中的现代等价物 - 重构热路径以减少不必要的状态更新
- 将复杂的视图 body 拆分为独立的子视图
- 当遇到
UIImage(data:)时,建议图像降采样(可选优化,参见references/image-optimization.md)
实现新的 SwiftUI 功能
- 先设计数据流:确定属于自身拥有的状态还是注入的状态
- 优化视图结构以实现高效差异比较(尽早拆分子视图)
- 应用正确的动画模式(隐式与显式动画、转场)
- 对所有可点击的元素使用
Button;添加无障碍分组和标签 - 使用
#available条件编译特定版本的 API,并提供回退方案
主题路由器
针对与当前任务相关的每个主题,查阅相应的参考文件:
| 主题 | 参考文件 |
|---|---|
| 状态管理 | references/state-management.md |
| 视图组合 | references/view-structure.md |
| 性能 | references/performance-patterns.md |
| 列表与 ForEach | references/list-patterns.md |
| 布局 | references/layout-best-practices.md |
| Sheet 和导航 | references/sheet-navigation-patterns.md |
| ScrollView | references/scroll-patterns.md |
| 动画(基础) | references/animation-basics.md |
| 动画(转场) | references/animation-transitions.md |
| 动画(高级) | references/animation-advanced.md |
| 无障碍 | references/accessibility-patterns.md |
| Swift Charts | references/charts.md |
| 图表无障碍 | references/charts-accessibility.md |
| 图像优化 | references/image-optimization.md |
| Liquid Glass(iOS 26+) | references/liquid-glass.md |
| macOS 场景 | references/macos-scenes.md |
| macOS 窗口样式 | references/macos-window-styling.md |
| macOS 视图 | references/macos-views.md |
| 已废弃 API 查询 | references/latest-apis.md |
正确性检查清单
以下为硬性规则——违反即视为 bug:
-
@State属性是private的 -
@Binding仅用于子视图修改父视图状态时 - 传入的值永远不会声明为
@State或@StateObject(它们会忽略更新) -
@StateObject用于视图拥有的对象;@ObservedObject用于注入的对象 - iOS 17+:
@State与@Observable配合使用;@Bindable用于需要绑定的注入可观察对象 -
ForEach使用稳定的标识(动态内容绝不使用.indices) - 每个
ForEach元素的视图数量恒定 -
.animation(_:value:)始终包含value参数 - iOS 26+ API 使用
#available条件编译并提供回退 - 使用图表类型的文件中包含
import Charts
参考文件
references/latest-apis.md—— 每项任务首先阅读。 从已废弃到现代的 API 过渡(iOS 15+ 至 iOS 26+)references/state-management.md—— 属性包装器、数据流、@Observable迁移references/view-structure.md—— 视图提取、容器模式、@ViewBuilderreferences/performance-patterns.md—— 热路径优化、更新控制、_logChanges()references/list-patterns.md—— ForEach 标识、Table(iOS 16+)、内联过滤陷阱references/layout-best-practices.md—— 布局模式、GeometryReader 替代方案references/accessibility-patterns.md—— VoiceOver、动态类型、分组、特征references/animation-basics.md—— 隐式/显式动画、时序、性能references/animation-transitions.md—— 视图转场、matchedGeometryEffect、Animatablereferences/animation-advanced.md—— 阶段/关键帧动画(iOS 17+)、@Animatable宏(iOS 26+)references/charts.md—— Swift Charts 标记、坐标轴、选择、样式、Chart3D(iOS 26+)references/charts-accessibility.md—— 图表 VoiceOver、音频图形、回退策略references/sheet-navigation-patterns.md—— Sheets、NavigationSplitView、Inspectorreferences/scroll-patterns.md—— ScrollViewReader、程序化滚动references/image-optimization.md—— AsyncImage、降采样、缓存references/liquid-glass.md—— iOS 26+ Liquid Glass 效果及回退模式references/macos-scenes.md—— Settings、MenuBarExtra、WindowGroup、多窗口references/macos-window-styling.md—— 工具栏样式、窗口大小、Commandsreferences/macos-views.md—— HSplitView、Table、PasteButton、AppKit 互操作