组合多个属性包装器
叠加属性包装器，并了解它们的初始化顺序。
组合多个属性包装器 是 CoddyKit 上的免费 Swift Academy 课时。 这是第 4 节课，共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 Swift Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Swift Academy 课程共包含 4 节课。
欢迎
可以将多个属性包装器应用于同一个属性。顺序很重要——外层包装器会包装内层包装器，并且初始化顺序遵循声明顺序。
叠加包装器
```swift
@propertyWrapper struct A { var wrappedValue: Int { didSet { print("A") } } init(wrappedValue: Int) { self.wrappedValue = wrappedValue } }
@propertyWrapper struct B { var wrappedValue: Int { didSet { print("B") } } init(wrappedValue: Int) { self.wrappedValue = wrappedValue } }
struct S { @A @B var x = 0 }
```
外层包裹内层
当您写下 `@A @B var x` 时，展开后的写法是：
```swift
var _x: A> = A(wrappedValue: B(wrappedValue: 0))
```
A 包裹 B，而 B 包裹 Int。
实际示例：@NonEmpty + @Trimmed
```swift
@propertyWrapper struct Trimmed {
var wrappedValue: String { didSet { wrappedValue = wrappedValue.trimmingCharacters(in:.whitespaces) } }
init(wrappedValue: String) { self.wrappedValue = wrappedValue.trimmingCharacters(in:.whitespaces) }
}
@propertyWrapper struct NonEmpty {
var wrappedValue: String { didSet { if wrappedValue.isEmpty { wrappedValue = "(empty)" } } }
init(wrappedValue: String) { self.wrappedValue = wrappedValue.isEmpty ? "(empty)" : wrappedValue }
}
struct Form { @NonEmpty @Trimmed var username = " " }
```
初始化顺序
包装器会按照从最外层到最内层的顺序初始化。这意味着外层包装器的初始化方法接收的是内层包装器转换后的结果，而不是原始值。
叠加的限制
• 并非所有包装器都能顺利组合——请检查 `wrappedValue` 的类型是否匹配
• Swift 编译器不一定总是允许使用多个包装器（取决于包装值类型是否兼容）
• 对投影值 `projectedValue` 的访问 `$x` 只能到达最外层包装器的投影值
SwiftUI 示例：@EnvironmentObject + 观察
SwiftUI 不允许在同一个属性上叠加 `@EnvironmentObject` 和 `@Published`，但您可以观察内部使用 `@Published` 的 `@EnvironmentObject` 模型。
调试叠加的包装器
使用 `_propertyName` 可以直接访问包装器实例：
```swift
print(form._username) // A> — the outer wrapper instance
```
替代方案：在一个包装器中组合
通常，将逻辑组合在单个包装器中会更清晰：
```swift
@propertyWrapper struct CleanUsername {
var wrappedValue: String {
didSet { wrappedValue = clean(wrappedValue) }
}
func clean(_ s: String) -> String {
let t = s.trimmingCharacters(in:.whitespaces)
return t.isEmpty ? "(empty)" : t
}
}
```
实用的叠加模式
常见的有效叠加方式：
• `@UserDefault` + `@Published`（数据持久化 + 观察）
• `@NonNegative` + `@Clamped`（验证层）
• 框架特定用法：SwiftUI 视图中的 `@Environment` + `@Binding`
快速检查
叠加两个属性包装器时，哪个会先初始化？
回顾
要点回顾：
• `@A @B var x` 会展开为 `A>`
• 外层包装器会以内层包装器的 wrappedValue 作为输入进行初始化
• `$x` 只能访问最外层的 projectedValue
• `_x` 可以直接访问包装器实例
• 如果可以，优先使用单个组合包装器，而不是深层叠加
课程完成！下一节：结果类型。
常见问题解答
「组合多个属性包装器」课时是免费的吗？
是的 — 「组合多个属性包装器」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Swift Academy 课程的其余内容，请升级到 CoddyKit PRO。 Swift Academy 课程共包含 4 节课。
「组合多个属性包装器」这节课中我会学到什么？
叠加属性包装器，并了解它们的初始化顺序。 你通过在浏览器中直接运行的动手代码来练习 Swift Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 Swift Academy 需要有经验吗？
无需任何先前经验。CoddyKit 上的 Swift Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 4 节课，共 4 节。
「组合多个属性包装器」课时需要多长时间？
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。
我能在这节 Swift Academy 课中编写并运行代码吗？
能。每节 Swift Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。