时间轴循环播放需手动设置终点值，如2秒循环3次则终点必须设为6.0；首尾关键帧属性、时间点（精确到0.001s）及插值类型须完全一致，否则出现顿挫或跳帧。
时间轴循环播放必须手动设终点，不能只点“循环”按钮
Composer（特指 SOLIDWORKS Composer）的时间轴本身不提供“自动循环”开关。点击循环图标 ↻ 只是让播放器在到达时间轴末尾时跳回起点重放——但如果时间轴终点没设对，它会截断最后一段，导致硬跳或黑帧。
常见错误现象：动画播到 5.9s 就卡住一帧，再跳回 0s；或者最后一秒动作被切掉一半。
- 导出前务必确认时间轴右端数值 ≥ 循环段总时长（例如 2s 段重复 3 次，终点至少设为
6.0） - 不要依赖拖动时间滑块“估摸着拉到尽头”，双击时间轴右下角的终点数值框，手动输入带一位小数的精确值，如
6.0、9.0 - 若用“复制粘贴关键帧”方式延长循环，粘贴后立刻按
Home键回到起点，拖动时间条逐帧检查是否真落在2.0、4.0这类整数秒位置
循环段首尾关键帧必须完全一致且时间严丝合缝
哪怕数值相同，只要时间点差 0.001s，Composer 就不会平滑衔接，而是在交界处插值“绕路”，造成肉眼可见的顿挫或弹跳。
使用场景：爆炸图收放、旋转部件周期运动、装配步骤反复演示。
- 关闭吸附功能：右键时间轴 → 取消勾选
Snap to Frame（或按Ctrl+Shift+S） - 首帧（如
0.0）和尾帧（如2.0）的位置/角度/可见性等所有属性必须完全相同，建议用“复制关键帧”而非重新打点 - 检查插值类型：选中首尾之间的全部关键帧 → 右键 →
Interpolation→ 统一设为Bezier，避免混用Linear或Hold
循环播放卡顿？先查采样率和系统时间同步
卡顿不是性能问题，而是时间基准错乱。Composer 读取的是本地文件时间戳和系统时钟，一旦偏差超阈值，关键帧顺序就可能错位。
性能 / 兼容性影响：在 WSL2、Docker 或 CI 环境中尤为明显；Windows 和 macOS 时间不同步也会触发。
- 在虚拟环境启动 Composer 前，确保挂载宿主机时区：
-v /etc/localtime:/etc/localtime:ro - CI 流水线（如 GitHub Actions）中，在运行
composer install前加两行：sleep 2和timedatectl timesync-status，等 NTP 校准完成 - 本地机器若长期未联网，手动执行
sudo ntpdate -s time.apple.com（macOS）或w32tm /resync（Windows）
Reality Composer Pro 的时间轴循环逻辑完全不同
如果你实际用的是 Apple 的 Reality Composer Pro，它的循环机制基于时间轴（Timeline）+ 触发条件（Trigger），不依赖“终点值”。但同样要求首尾状态匹配，否则过渡生硬。
参数差异：它支持 loopCount 属性和 autoreverses 开关，但这些只对单个时间轴生效；跨多个时间轴联动需用 Swift 代码绑定。
- 在 Reality Composer Pro 中，循环由 Swift 侧控制：调用
timeline.play(loops: .indefinite)才真正无限循环 - UI 上设的
Duration是单次播放时长，不是时间轴总长；时间轴可远长于该值，多余部分不会自动裁剪 - 导出为 USDZ 后，循环行为丢失——必须在 AR app 中用代码重新启用
关键帧时间精度和系统时钟同步是多数人忽略的底层前提。手动输入 2.0 而非拖动对齐，比调任何动画参数都重要。
