创建自定义属性包装器
使用 @propertyWrapper 和 wrappedValue 封装逻辑。
创建自定义属性包装器 是 CoddyKit 上的免费 Swift Academy 课时。 这是第 1 节课，共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 Swift Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Swift Academy 课程共包含 4 节课。
欢迎
属性包装器封装了属性存储逻辑，让您可以重用验证、转换或持久化等样板代码。
基本语法
```swift
@propertyWrapper
struct Clamped {
var wrappedValue: Int { didSet { wrappedValue = min(max(0,wrappedValue),100) } }
init(wrappedValue: Int) { self.wrappedValue = min(max(0,wrappedValue),100) }
}
struct Gauge {
@Clamped var level = 50
}
var g = Gauge()
g.level = 150 // clamped to 100
```
wrappedValue 要求
每个属性包装器都必须定义 `wrappedValue`。包装器的使用者正是通过它读取和写入属性的。
泛型属性包装器
```swift
@propertyWrapper
struct Logged {
private var value: T
var wrappedValue: T {
get { print("get"); return value }
set { print("set to \(newValue)"); value = newValue }
}
init(wrappedValue: T) { value = wrappedValue }
}
```
使用包装器
```swift
struct Model {
@Logged var name: String = "Default"
}
var m = Model()
let n = m.name // prints "get"
m.name = "Alice" // prints "set to Alice"
```
自定义初始化器参数
```swift
@propertyWrapper
struct Default {
var wrappedValue: T
init(wrappedValue: T) { self.wrappedValue = wrappedValue }
init(_ default: T) { wrappedValue = default }
}
@Default(42) var count: Int
```
存储属性与计算属性上的包装器
属性包装器会添加隐藏的存储空间（包装后的值）。带注解的属性只是语法糖：
```swift
@Clamped var level = 50
// Desugars to:
var _level = Clamped(wrappedValue: 50)
var level: Int { get { _level.wrappedValue } set { _level.wrappedValue = newValue } }
```
UserDefaults 包装器
```swift
@propertyWrapper
struct UserDefault {
let key: String; let defaultValue: T
var wrappedValue: T {
get { UserDefaults.standard.object(forKey: key) as? T ?? defaultValue }
set { UserDefaults.standard.set(newValue, forKey: key) }
}
}
@UserDefault(key:"theme",defaultValue:"light") var theme: String
```
线程安全的包装器
```swift
@propertyWrapper
final class Atomic {
private var value: T; private let lock = NSLock()
var wrappedValue: T {
get { lock.lock(); defer { lock.unlock() }; return value }
set { lock.lock(); defer { lock.unlock() }; value = newValue }
}
init(wrappedValue: T) { value = wrappedValue }
}
```
在一个类型中组合包装器
```swift
struct Settings {
@Clamped var volume = 50
@UserDefault(key:"username",defaultValue:"") var username: String
@Logged var debugMode = false
}
```
快速检查
每个 `@propertyWrapper` 类型都必须包含哪个属性？
回顾
要点：
• `@propertyWrapper` + `wrappedValue` = 最基本的属性包装器
• 包装器会添加隐藏的 `_name` 存储空间
• 泛型包装器可以处理任意类型 T
• 常见用途：限幅、日志记录、UserDefaults、线程安全
• 自定义初始化器参数可以进行配置
下一节：投影值。
常见问题解答
「创建自定义属性包装器」课时是免费的吗？
是的 — 「创建自定义属性包装器」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Swift Academy 课程的其余内容，请升级到 CoddyKit PRO。 Swift Academy 课程共包含 4 节课。
「创建自定义属性包装器」这节课中我会学到什么？
使用 @propertyWrapper 和 wrappedValue 封装逻辑。 你通过在浏览器中直接运行的动手代码来练习 Swift Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 Swift Academy 需要有经验吗？
无需任何先前经验。CoddyKit 上的 Swift Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 1 节课，共 4 节。
「创建自定义属性包装器」课时需要多长时间？
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。
我能在这节 Swift Academy 课中编写并运行代码吗？
能。每节 Swift Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。