审查 SwiftUI 代码的视图组合、状态管理、性能和可访问性。在审查包含 SwiftUI 视图的 .swift 文件时使用，遵循最佳实践。
快速引用 快速引用 快速引用 快速引用 视频提取 修改 机体复杂度 参考/视图-组合. md
功能概述
快速引用 快速引用 快速引用 快速引用 视频提取 修改 机体复杂度 参考/视图-组合. md是一项面向实际任务的技能，主要用于@=状态, @Binding, @Observeable, @Bindable.References/state-managem。它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。
核心要点
- 使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。
- 从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。
- 实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；
使用与执行
若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；
结果检查与注意事项
涉及批量任务时，还应保存进度，避免中断后重复操作。该技能适合用于一次性任务，也可以接入自动化工作流，与其他技能或上层代理配合完成更完整的业务链路；在组合使用时，应明确每一步的输入输出关系，并避免不同步骤之间出现参数冲突。
SwiftUI 代码审查
快速参考
| 问题类型 | 参考文档 |
|---|---|
| 视图提取、修饰符、body 复杂度 | references/view-composition.md |
| @State、@Binding、@Observable、@Bindable | references/state-management.md |
| LazyStacks、AnyView、ForEach、identity | references/performance.md |
| VoiceOver、动态字体（Dynamic Type）、标签（labels）、特性（traits） | references/accessibility.md |
审查关卡（review workflow）
请按顺序完成；不得跳过任一环节。
- 锚定作用域（Anchor scope） —— 通过条件：每个被审查的文件均以仓库相对路径形式列出，且扩展名为
.swift（或审查中明确声明“未打开任何文件 / N/A”，并附合理由）。 - 先查参考，再提批评 —— 通过条件：针对任何非平凡的 body、修饰符链或包装器所有权相关问题，你已打开上表中对应行的
references/*.md文档 或 明确注明“无需参考”，并用一句话说明原因。 - 基于证据的发现 —— 通过条件：每一项实质性问题均在建议前标注明确位置锚点
[FILE:LINE]（或限定行范围）；符号/代码片段可作为补充，但不可替代位置锚点；不得仅凭“典型的 SwiftUI 实践”提出问题，而未指向当前代码的具体位置。
审查清单
- 视图 body 中组合元素少于 10 个（否则应提取为子视图）
- 修饰符顺序正确（例如 padding 应在 background 之前）
- 使用 @StateObject 管理视图自有对象，使用 @ObservedObject 接收外部传入对象
- 在 iOS 17+ 中，对 @Observable 类型使用 @Bindable 实现双向绑定
- 对含 50 个以上条目的滚动列表，使用 LazyVStack / LazyHStack
- 不使用 AnyView（改用 @ViewBuilder 或泛型）
- ForEach 使用稳定且符合 Identifiable 协议的 ID（而非数组索引）
- 所有图片/图标均设置 accessibilityLabel
- 自定义控件添加 accessibilityAddTraits(.isButton)
- 支持动态字体（Dynamic Type），不使用固定字号
- 异步任务使用 .task 修饰符（而非 onAppear + Task）
何时查阅参考文档
- 视图 body 或修饰符链较复杂 → 查阅 view-composition.md
- 属性包装器使用（如 @State、@Observable）→ 查阅 state-management.md
- 列表性能或视图身份（view identity）相关问题 → 查阅 performance.md
- VoiceOver 或无障碍功能实现 → 查阅 accessibility.md
审查问题
- 该大型视图 body 是否可拆分为更小、可复用的 View？
- 修饰符顺序是否为有意为之？（例如 padding → background → frame）
- @StateObject / @ObservedObject 的所有权使用是否恰当？
- LazyVStack 是否能提升该 ScrollView 的性能？
- VoiceOver 用户能否理解此界面？
相关专题
Vite项目打包部署专题汇集生产构建、产物预览、输出目录、资源路径、Nginx与GitHub Pages部署及常见白屏和路由404问题的已审核文章，帮助读者完成上线流程。
2026.10.28
0
16
Vite搭配Vue.js专题汇集创建Vue 3项目、配置开发环境、路径别名、Vue插件、代理、多环境构建与调试的已审核文章，帮助读者完成从初始化到日常开发的配置。
2026.10.28
0
15
Vite项目目录专题汇集入口文件、src源码、public静态资源、路径别名、项目根目录和构建输出目录相关的已审核文章，帮助读者理解各文件夹的用途与引用方式。
2026.10.28
0
10
本专题介绍Gradle插件开发的基本流程，涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法，帮助你理解插件如何组织构建逻辑，减少多个项目之间的重复配置。
2026.10.22
0
11
本专题介绍Gradle Wrapper的基本作用，涵盖文件组成、生成方法、版本配置和任务调用，帮助你理解项目如何使用指定的Gradle版本，减少不同开发环境带来的构建差异。
2026.10.22
0
10
本专题整理Golangci-lint常用Linters的用途与配置方法，覆盖错误处理、无效代码、安全、复杂度、命名和依赖检查，帮助项目合理选规则。
2026.10.22
0
15
本专题介绍Gradle Java项目构建方法，涵盖Java插件配置、依赖声明、源码编译、测试执行和打包检查，帮助你理解各阶段的任务关系，逐步完成项目构建。
2026.10.22
0
10
本专题汇总PHP常见时间戳漏洞，包括2038年溢出、时区漂移、时间戳伪造、重放攻击、时间盲注与日志审计失效等，并给出升级64位环境、使用 DateTimeImmutable、统一UTC、严格超时校验、预处理绑定、hash_equals 比对等修复方案，帮助开发者快速排查和加固时间相关代码。
2026.10.22
0
25
本专题聚焦Golangci-lint YAML配置文件，讲清运行参数、规则启停、目录排除、问题过滤及严重级别设置，便于团队统一检查标准。
2026.10.22
0
15
热门下载
相关下载
精品课程
共6课时 | 54.7万人学习
共89课时 | 134.1万人学习
共49课时 | 82.5万人学习
最新文章