
## 为什么选择 Tween？

Godot 4 带来的全新 Tween 系统，摒弃了传统的节点式操作，改用全代码驱动，更加简洁且强大。

Tween：适合程序化、动态的 UI 反馈、物品掉落、数值平滑变化（纯代码控制）。

## 核心语法

创建一个最基本的平移动画：


    var tween = create_tween()
    tween.tween_property($Sprite2D, "position", Vector2(600, 300), 1.0)


只需两行，对象就会在 1 秒内平滑移动到目标位置。


## 让动画有灵魂：Transition 与 Ease

1. set_trans()：过渡类型 (TransitionType) 这是最核心的参数，决定了动画的“性格”。

| 枚举常量 (Tween.TransitionType) | 动画效果描述                     | 最佳用途                         |
|-------------------------------|----------------------------------|----------------------------------|
| `TRANS_LINEAR`                | 匀速。没有任何加减速。           | 简单的旋转、血条数值变化。       |
| `TRANS_SINE`                  | 正弦。非常柔和的加速减速。       | 缓慢漂浮、呼吸灯效果。           |
| `TRANS_QUAD`                  | 二次方。基础的加减速。           | 最常用的平滑移动。               |
| `TRANS_CUBIC`                 | 三次方。比 Quad 更明显的加减速。 | 强调动作起伏。                   |
| `TRANS_QUART`                 | 四次方。加速感更强。             | 快速切入/切出。                  |
| `TRANS_EXPO`                  | 指数级。极端的加减速。           | 闪电般的瞬间移动。               |
| `TRANS_ELASTIC`               | 弹性。像皮筋拉伸后的回弹。       | Q弹的按钮、果冻物体。            |
| `TRANS_BOUNCE`                | 反弹。像球落地后的弹跳。         | 物理掉落效果、菜单撞击边缘。     |
| `TRANS_BACK`                  | 回退。先往后拉一点再冲出去。     | 蓄力感的动作、浮窗弹出。         |
| `TRANS_SPRING`                | 弹簧。真实的物理弹簧震荡。       | Godot 4 新增，比 Elastic 更自然。|

2. set_ease()：缓动模式 (EaseType)这个参数决定了上面选定的曲线如何应用在时间轴上。

| 枚举常量 (Tween.EaseType) | 逻辑描述           | 视觉表现                                      |
|--------------------------|--------------------|-----------------------------------------------|
| `EASE_IN`                | 入场加速。         | 动画开始时很慢，然后加速。常用于离开屏幕。     |
| `EASE_OUT`               | 出场减速。         | 动画开始时很快，快结束时减慢。UI 动画最常用。 |
| `EASE_IN_OUT`            | 两头慢中间快。     | 开始和结束都有缓冲。适合循环往复的动作。       |
| `EASE_OUT_IN`            | 两头快中间慢。     | 较少使用。                                    |


3. 黄金组合建议 如果你不知道该选什么，可以尝试这些经过验证的经典组合：

* 自然的 UI 弹出： set_trans(Tween.TRANS_BACK).set_ease(Tween.EASE_OUT)

* 丝滑的淡入淡出： set_trans(Tween.TRANS_SINE).set_ease(Tween.EASE_IN_OUT)

* 有打击感的移动： set_trans(Tween.TRANS_QUART).set_ease(Tween.EASE_OUT)

* 极度夸张的点击反馈： set_trans(Tween.TRANS_ELASTIC).set_ease(Tween.EASE_OUT)


## 动态演示

你可以将下面的脚本挂载到一个空的 Node2D 场景中。运行后，它会生成一排图标，演示各种常见的 Tween 曲线。

    extends Node2D

    # 使用 Godot 的默认图标作为演示物体
    var icon_texture = preload("res://icon.svg")

    # 定义我们要演示的配置组合
    var setups = [
        {"name": "Linear", "trans": Tween.TRANS_LINEAR, "ease": Tween.EASE_IN_OUT},
        {"name": "Sine Out", "trans": Tween.TRANS_SINE, "ease": Tween.EASE_OUT},
        {"name": "Back Out", "trans": Tween.TRANS_BACK, "ease": Tween.EASE_OUT},
        {"name": "Bounce Out", "trans": Tween.TRANS_BOUNCE, "ease": Tween.EASE_OUT},
        {"name": "Elastic Out", "trans": Tween.TRANS_ELASTIC, "ease": Tween.EASE_OUT},
        {"name": "Quint In", "trans": Tween.TRANS_QUINT, "ease": Tween.EASE_IN}
    ]

    func _ready():
        # 为每种配置创建一个演示行
        for i in range(setups.size()):
            create_demo_row(i, setups[i])

    func create_demo_row(index, config):
        # 1. 创建并添加精灵
        var sprite = Sprite2D.new()
        sprite.texture = icon_texture
        sprite.scale = Vector2(0.5, 0.5)
        sprite.position = Vector2(100, 100 + index * 100)
        add_child(sprite)
        
        # 2. 创建并添加标签文字
        var label = Label.new()
        label.text = config["name"]
        label.position = Vector2(20, 70 + index * 100)
        add_child(label)
        
        # 3. 启动循环动画函数
        animate_sprite(sprite, config)

    func animate_sprite(sprite, config):
        var start_pos = Vector2(100, sprite.position.y)
        var end_pos = Vector2(1000, sprite.position.y)
        
        # 创建 Tween
        var tween = create_tween().set_loops() # 无限循环
        
        # 设置当前行的过渡和缓动参数
        tween.set_trans(config["trans"])
        tween.set_ease(config["ease"])
        
        # 动画序列：移动到右边 -> 等待 -> 瞬移回左边
        tween.tween_property(sprite, "position", end_pos, 2.0)
        tween.tween_interval(0.5)
        tween.tween_property(sprite, "position", start_pos, 0.0) # 瞬移回起始点
        tween.tween_interval(0.5)



运行游戏后的效果：

![效果图](https://www.suiyan.cc/assets/images/2025/Snipaste_2026-01-19_16-10-04.png)


这段代码展示了几个关键技巧：

* set_loops(): 让动画自动重复。注意在 Godot 4 中，不带参数的 set_loops() 表示无限循环。

* tween_interval(): 在往返运动之间加入停顿，方便观察终点的回弹或碰撞效果。

* 瞬移技巧: 将 duration 设置为 0.0 的 tween_property 可以当作“瞬间改变属性”来使用。

* 动态组合: 你可以轻松地在 setups 数组里添加更多组合，比如对比 EASE_IN 和 EASE_OUT 的区别。

## 总结与建议

UI 弹出：首选 TRANS_BACK + EASE_OUT。

打击感：试试 TRANS_QUINT 或 TRANS_EXPO。

生命周期：不需要手动 queue_free()，Tween 运行完会自动消失。

中断处理：如果需要在动画中途停止，可以调用 tween.kill()。

Godot 4 带来的全新 Tween 系统，摒弃了传统的节点式操作，改用全代码驱动，更加简洁且强大。

标签: 动画

Godot 4 补间动画 (Tween) 指北