问题描述
当前我们在unity的开发过程中，会大量使用到timeline，在 Timeline 动画轨道挂载角色动作，绝大多数场景只需要动作完整播放 1 次，如果出现Timeline 完整播放结束后，角色动画不会定格在动画最后一帧，反而持续无限循环播放。怎么办？
为了解决这个问题，我们首先要了解引发问题的根源究竟是出现在哪里。
问题根源
在 Unity Timeline 开发中，当时间轴播放完毕 / 停止后，绑定的角色动画仍持续循环、无法定格在动画最后一帧，核心诱因分为三类：
1.PlayableDirector 循环模式（Wrap Mode）配置错误，设为 Loop 会重复整段 Timeline；
2.动画轨道剪辑空白外推模式不是 Hold，轨道结束后脱离 Timeline 管控，Animator 自动执行自身循环；
3.动画 Clip 本身勾选Loop Time，或 Animator 状态机形成闭环跳转。
Timeline与动画播放的机制
一、核心区别
Unity 存在两套独立动画驱动，Timeline 属于Playable 线性时序系统，Animator 是状态机分支系统，二者同时驱动骨骼时存在权重竞争逻辑：
| 系统 | 核心逻辑 | 数据驱动方式 | 适用场景 |
|---|---|---|---|
| Animator Controller | 分支状态机，按参数跳转动画 | 每帧自主更新状态，持续运行 | 角色常规移动、待机循环、交互动作 |
| Timeline（Playable） | 线性时间轴，严格按时间顺序播放片段 | PlayableDirector 统一调度帧数据，有起止边界 | 剧情 CG、固定连招、一次性过场动画 |
核心冲突根源：Timeline 仅在播放区间内接管动画控制权；一旦播放头走出动画剪辑区间 / 时间轴结束，控制权会交还给 Animator，若 Animator 自身配置为循环，动作就会重复播放。
二、Timeline动画播放机制
PlayableDirector.WrapMode（时间轴全局结束行为）
由挂载 Timeline 的物体上PlayableDirector组件控制，定义整条时间轴播放完毕后的全局行为，优先级最高：
- Hold（推荐单次动画）：完整播放一次，结束后锁定时间轴最后一帧，持续输出该帧动画数据，持续接管 Animator 控制权，不会退回状态机循环。
- Loop：时间轴播放完自动回到 0 帧从头循环，对应你遇到的 “动作重复播放” 场景。
- None：播放结束后立刻释放所有动画控制权，骨骼属性全部重置为播放前初始值，无法定格。
Animation 轨道剪辑 Post-Extrapolate
单段动画剪辑播放完毕、但时间轴还未走到末尾时，空白区间的动画填充规则，是最容易被忽略的循环诱因Unity：
- Hold：剪辑结束后空白区间持续输出动画最后一帧，锁定姿态；
- Loop：剪辑结束后在空白区间无限重复当前动画片段，哪怕整条 Timeline 只播放一次，这段动作也会循环；
- Ping Pong：正向播放完反向倒放，往复循环；
- None：空白区间放弃动画数据，骨骼切回 Animator 原生状态。
动画 Clip 自身循环属性与 Animator 状态机兜底
当 Timeline 完全释放控制权（时间轴结束、无外推 Hold），动画会回到 Animator 自身逻辑：
- 动画资源Loop Time勾选：Clip 原生支持首尾循环；
- Animator 状态机存在闭环连线（动作→Exit→Entry）：播放完成自动切回初始循环状态；
- Animator 默认持续执行 Update，无外部时序压制时自主循环动作。
解决方案
第一步：排查PlayableDirector
1.选中挂载 Timeline 资源的物体；
2.在右侧 Inspector 找到 Playable Director 组件。
3.将 Wrap Mode 设置为 Hold
运行游戏，如果动作仍循环，进入第二步排查。
第二步：排查动画剪辑 Post-Extrapolate
1.打开 Timeline 窗口，点击 Animation 轨道内任意动画色块，选中剪辑；
2.右侧 Inspector 面板展开 Animation Extrapolation 折叠栏；
3.找到 Post-Extrapolate统一设置为 Hold。
运行游戏，如果动作仍循环，进入第三步排查。
排查动画资源 & Animator 状态机
1.Project 窗口选中对应动画资源；
2.Inspector 面板取消勾选 Loop Time；
本专栏记录Unity新手小白的学习成长之路，愿和大家一同钻研、共同进步。文章若有疏漏或错误，欢迎各位大佬在评论区指正，我会及时勘误优化。觉得内容对你有帮助，不妨点个关注，后续持续更新Unity实用干货！本文部分内容由 AI 辅助整理生成
