代码精讲：WWDC 25 @Animatable 宏 —— SwiftUI 动画的新突破

🚀 代码绝地：WWDC 25 揭秘 @Animatable 动画宏的新原力

在 SwiftUI 的银河帝国里，动画向来是绝地武士手中最锋利的光剑 ------ 流畅丝滑、势如破竹。

而今年的 WWDC 25 就像一场突如其来的原力觉醒，苹果甩出了 @Animatable 这个新招式，让动画实现从 "西斯般的复杂咒语" 变成 "绝地学徒都能上手的基础招式"。

在本次星际穿越中，各位绝地小武士们将会学到如下招式：

🚀 代码绝地：WWDC 25 揭秘 @Animatable 动画宏的新原力
🛠️ 开篇：那些年，动画在 SwiftUI 里的 "小别扭"
✨ 原力觉醒：@Animatable 宏登场，动画从此 "一键超光速"
🚫 剔除 "杂质"：@AnimatableIgnored 宏的 "净化术"
🎯 总结：动画原力，尽在 "一键" 之间

今天，咱们就钻进代码的星际战斗机，看看这新宏是怎么让动画在 SwiftUI 的宇宙里超光速飞行的！

Let's go！！！;)

🛠️ 开篇：那些年，动画在 SwiftUI 里的 "小别扭"

SwiftUI 的动画功底向来是江湖一绝 ------ 就像卢克的光剑总能精准切开敌人的防御盔甲，复杂动画往往几行代码就能搞定。

但总有那些时候，它会像 R2-D2 突然卡壳：比如想让一个数字从 0 平滑蹦到 100，它偏要耍几次小性子，要么 "嗖" 一下跳过去，要么像被帝国风暴兵打中的机器人，一顿一顿地抽搐着。

不信？看看这个朴素到像塔图因沙漠小屋的 IntegerView：

swift 复制代码

struct IntegerView: View {
    var number: Int
    
    var body: some View {
        Text(number.formatted())
    }
}

struct ContentView: View {
    @State private var number = 0
    
    var body: some View {
        NavigationStack {
            VStack {
                IntegerView(number: number)
                    .animation(.default.speed(0.5), value: number)
                    .font(.system(size: 88, weight: .black, design: .rounded))
                
                Button(""非原力"动画") {
                    number = number == 100 ? 0 : 100
                }
                .buttonStyle(.borderedProminent)
            }
            .navigationTitle("塔图因沙漠小屋")
            .toolbar {
                Text("大熊猫侯佩 @ \(Text("CSDN").foregroundStyle(.red.gradient))")
                    .foregroundStyle(.gray)
                    .font(.headline.bold())
                    .padding(.horizontal)
                    .fixedSize()
            }
        }
    }
}

运行这段代码宝子们就会发现：数字变更是 "啪" 一下完成的，跟被汉・索罗的爆能枪打中似的，毫无过渡 ------ 因为 SwiftUI 这时候就像个迷路的帝国侦察兵，压根不知道怎么让数字 "一步一步走"。

这时候，咱们就得给它指条明路：告诉它哪些属性该 "慢慢挪"，这正是 Animatable 协议的活儿。

但在以前，这协议用起来就像拆解死星的核心 ------ 步骤繁琐，还容易出错。

那么，微秃绝地小武士们此时该何去何从呢？

✨ 原力觉醒：@Animatable 宏登场，动画从此 "一键超光速"

WWDC 25 带来的 @Animatable 宏，就像突然降临的尤达大师，三两下就把复杂问题捋顺了。

更多 WWDC 25 @Animatable 宏的详细介绍，请各位宝子们移步如下链接观赏精彩的内容：

WWDC 25 新功能：@Animatable 宏的深度解析

现在，小伙伴们不用再手动给视图"灌输" Animatable 协议的知识，只需给视图加个标记，它就自动学会 "优雅动画" 的秘籍！

且看看改造后的 IntegerView：

swift 复制代码

@Animatable
struct IntegerView: View {
    var number: Float
    
    var body: some View {
        Text(number.formatted(.number.precision(.fractionLength(0))))
    }
}

这里有两个关键变化，得拎出来说道说道：

加了 @Animatable 宏：这就像给视图注入了动画原力，它会自动遵循 Animatable 协议，不用你再写一堆烦人的"咒语"；
数字类型从 Int 换成了 Float：这可不是随便换的 ------@Animatable 宏只认那些 "懂向量算术" 的类型（也就是遵循 VectorArithmetic 协议的类型），就像星际飞船只能加特定型号的燃料，Int 这种 "固体燃料" 它可不感冒哦；

再看 ContentView 的配套修改：

swift 复制代码

struct ContentView: View {
    @State private var number: Float = 0
    
    var body: some View {
        NavigationStack {
            VStack {
                IntegerView(number: number)
                    .animation(.default.speed(0.5), value: number)
                    .font(.system(size: 88, weight: .black, design: .rounded))
                
                Button(""原力"动画") {
                    number = number == 100 ? 0 : 100
                }
                .buttonStyle(.borderedProminent)
            }
        }
    }
}

现在再运行，数字从 0 到 100 的变化就像义军战机穿越小行星带 ------ 流畅得能让人拍手叫绝！

🚫 剔除 "杂质"：@AnimatableIgnored 宏的 "净化术"

有时候，视图里的属性就像星际走私船上的多余货物 ------ 你不想让它们跟着动画"乱晃悠"。

这时候，@AnimatableIgnored 宏就像个严格的海关检查员，能把这些属性从动画名单里踢出去。

比如像这样：

swift 复制代码

@Animatable
struct IntegerView: View {
    var number: Float
    
    @AnimatableIgnored
    var ignoredValue: Float
    
    var body: some View {
        Text(number.formatted(.number.precision(.fractionLength(0))))
    }
}

而且这宏特懂事：如果宝子们的视图早就自己学会了 Animatable 协议（手动遵循过），它也不会瞎捣乱，就像尤达大师不会去纠正已经掌握原力的卢克 ------ 该咋动还咋动，互不干扰。

🎯 总结：动画原力，尽在 "一键" 之间

对比维度	旧的 Animatable 协议	新的 @Animatable 宏	相同点
核心功能	允许视图属性实现平滑动画，需手动定义动画插值逻辑	自动为视图添加动画能力，无需手动编写插值逻辑	均用于实现 SwiftUI 视图属性的平滑动画，最终都依赖 Animatable 协议的底层机制
使用复杂度	需手动遵循协议，实现 `animatableData` 属性及更新逻辑，步骤繁琐（如同手动组装光剑核心）	仅需添加 `@Animatable` 标记，自动完成协议适配（如同按下光剑启动按钮）	都能让视图属性支持动画过渡，效果一致
支持的属性类型	需手动处理 `VectorArithmetic` 类型的属性映射	自动适配所有 `VectorArithmetic` 类型属性，无需手动映射	均只支持遵循 `VectorArithmetic` 协议的类型（如 Float、CGFloat 等）
灵活性	可完全自定义动画插值逻辑，适合复杂场景（如同绝地大师自定义原力招式）	默认动画所有存储属性，可通过 `@AnimatableIgnored` 排除指定属性	都可控制哪些属性参与动画（旧协议通过代码筛选，新宏通过标记筛选）
兼容性	无冲突，可独立使用	若视图已手动遵循 Animatable 协议，宏不会干扰原有逻辑	两者可共存，宏不会覆盖手动实现的协议逻辑
适用场景	复杂动画需求，需精细控制插值过程	简单到中等动画需求，追求快速实现（如同义军战机的自动驾驶模式）	均可用于任何需要属性平滑过渡的 SwiftUI 视图

@Animatable 宏就像 SwiftUI 宇宙里的新恒星，用一道光就照亮了动画实现的捷径：

不用再手动写 Animatable 协议的"繁文缛节"，一个标记就能让属性动画 "自动觉醒"；
想排除某个属性？@AnimatableIgnored 就像绝地的"原力推"，轻松把它请出动画队列；
它和老的 Animatable 协议还能和平共处，就像新老绝地武士在圣殿里和谐共存；

在代码的银河里，动画曾是许多开发者的 "asteroid field"（小行星带）------ 想穿过去？得小心翼翼、步步为营。

但 @Animatable 宏的出现，就像给小伙伴们的代码装上了 "自动驾驶"，从此动画实现如履平地，顺滑得能让西斯领主都忍不住点赞。记住：原力（和动画）与你同在，而现在，它更听话了！

感谢观赏！各位微秃绝地小武士们，我们下次再会！8-)