iOS 动画代码审查

速查表

硬性门禁（执行顺序）

对本次审查范围内的文件，**必须严格按顺序**完成以下步骤。若任一环节未通过，则需 **跳过该问题发现**、**重新锚定定位** 或 **降级为提问项** —— 不得在未满足通过条件时直接提出指控性结论。

输出格式

每个问题发现均按如下格式报告：

[FILE:LINE] ISSUE_TITLE

示例：[AnimatedCard.swift:42] Missing Reduce Motion fallback for spring animation

所有详细说明、代码建议及理由均置于标题行之后。

审查检查清单

• 已检查 @Environment(.accessibilityReduceMotion) — 所有动画均已提供 Reduce Motion 回退方案
• 动画并非唯一反馈通道 — 重要状态变更已配合触觉反馈（.sensoryFeedback）或音频提示
• 自定义动画未重复实现系统已提供的动效（如标准导航过渡、sheet 呈现、SF Symbol 动效等）
• 频繁交互场景下的动画简短且不干扰用户 — 或完全省略（由系统自动处理）
• 所有动画均可被中断 — 用户无需等待动画完成即可进行交互
• 弹性动画使用 duration/bounce 参数（除非是 UIKit/CA 层，否则避免直接使用 mass/stiffness/damping 等底层参数）
• 未使用已弃用的无 value: 参数的 .animation()
• withAnimation 包裹的是状态变更逻辑，而非视图声明
• matchedGeometryEffect 所用 ID 在其命名空间内稳定且唯一
• 当父容器几何属性发生动画且子视图随之出现时，已使用 geometryGroup()
• 循环动画（如 PhaseAnimator、symbolEffect）具有有限相位数或恰当触发机制
• UIView 所支持的图层中未调用 CATransaction.setAnimationDuration()（应改用 UIView.animate）
• 交互式动画能正确处理中断（中途重新触发不会破坏状态一致性）
• 阴影动画已显式指定 shadowPath（避免逐帧重计算）
• 手势驱动的动画在释放时保留速度，以实现自然收尾
• 手势驱动的反馈符合空间预期（例如：关闭方向与展开方向一致）
• 未对 .id() 修饰符进行动画（此举会破坏视图身份；应改用 transition 或 matchedGeometryEffect）

何时查阅参考文档

• 弹性动画配置错误或 withAnimation 作用域问题 → swiftui-animation-patterns.md
• 卡顿、掉帧，或滚动视图中存在高开销动画 → performance.md
• 缺失 Reduce Motion 处理或运动相关无障碍适配 → accessibility.md
• matchedGeometryEffect 显示异常，或自定义 Transition 存在缺陷 → transitions.md

审查提问清单

1. 每个动画是否都具备 Reduce Motion 回退方案，并确保传达的信息完整？动画是否是唯一的反馈通道，还是已辅以触觉或音频反馈？
2. 该自定义动画是否必要？系统是否已提供对应能力（如标准过渡、SF Symbol 动效、Liquid Glass）？
3. 该动画是否可能导致掉帧？是否在列表或滚动视图中对高开销属性（如模糊、无 shadowPath 的阴影、遮罩）进行了动画？
4. 所有动画是否均可中断？用户能否在不等待动画完成的情况下进行操作？手势驱动的反馈是否符合空间预期？
5. withAnimation 是否仅包裹了最小必需的状态变更？是否存在包裹无关状态修改的情况？
6. 针对 matchedGeometryEffect：源与目标是否使用相同的 ID 和命名空间？是否保证同一时刻仅有一个可见？