为值语义设计 API
设计公共接口和框架时，学习如何在结构体与类之间做出选择。
为值语义设计 API 是 CoddyKit 上的免费 Swift Academy 课时。 这是第 4 节课，共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 Swift Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Swift Academy 课程共包含 4 节课。
欢迎
围绕值语义设计应用程序接口，会带来可预测、线程安全且易于测试的代码。让我们看看做出这一选择时所依据的原则和模式。
值语义契约
类型具有值语义，当且仅当：
• 两个独立副本始终彼此独立
• 修改一个副本永远不会影响另一个副本
• 类型的行为类似 `Int`——`a = b; a += 1` 不会改变 `b`
公共应用程序接口：优先返回值类型
```swift
// Reference semantics — caller shares state:
func getUser() -> UserClass { ... }
// Value semantics — caller gets independent copy:
func getUser() -> UserStruct { ... }
```
值类型的返回值会保护内部状态不受外部修改。
不可变引用类型
当一个类始终不可变时，它的行为类似值类型：
```swift
final class Token {
let value: String
init(_ v: String) { value = v }
// No mutable state — safe to share freely
}
```
选择结构体而非类的检查清单
以下情况优先使用结构体：
✓ 类型表示数据而非身份
✓ 不需要继承
✓ 实例不应被共享或产生别名
✓ 可以通过比较字段值判断相等
✓ 与 Swift 并发配合良好（可发送）
可发送性与值语义
Swift 6 并发要求跨越参与者边界的类型符合 `Sendable`：
```swift
struct Message: Sendable { var text: String; var timestamp: Date }
// Safe to pass between actors
```
所有属性都支持可发送性的值类型会自动符合 `Sendable`。
让类接口具备值安全性
```swift
struct Config {
// Expose value snapshot instead of the class:
func snapshot() -> Config { self } // copy by value semantics
}
// Or use a value-type DTO:
struct UserDTO: Sendable { var id: UUID; var name: String }
```
使用值类型的构建器模式
```swift
struct Request {
var url: URL
var method: String = "GET"
var headers: [String:String] = [:]
func adding(header: String, value: String) -> Request {
var copy = self
copy.headers[header] = value
return copy
}
}
let r = Request(url: url).adding(header: "Auth", value: "Bearer x")
```
应用程序接口文档传达的信息
选择结构体而不是类，会向应用程序接口的使用者传达清晰的信息：
• “这是数据——可以自由复制”
• “修改您的副本不会影响我的副本”
• “在各处传递它是线程安全的”
这样可以减少使用者代码中防御性复制的需要。
何时接受引用语义
在以下情况下接受类/引用语义：
• 身份很重要（`===`）：两个 User 对象可以代表同一个人
• 共享可变状态就是功能：`Database`、`Cache`、`AudioEngine`
• Objective-C 互操作：UIKit、AppKit 类型是类
• 生命周期回调：通过 `deinit` 清理资源
快速检查
在 Swift 并发中，哪个 Swift 关键字会标记类型，使其可以安全地跨越参与者边界传递？
回顾
要点回顾：
• 值语义：修改局部化，不产生别名
• 数据模型优先使用结构体；身份和生命周期使用类
• 不可变类的行为类似值类型
• `Sendable` + 值类型 = 安全并发
• 使用结构体复制实现的构建器模式可以创建简洁的不可变接口
课程完成！下一节：ARC 与内存管理模式。
常见问题解答
「为值语义设计 API」课时是免费的吗？
是的 — 「为值语义设计 API」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Swift Academy 课程的其余内容，请升级到 CoddyKit PRO。 Swift Academy 课程共包含 4 节课。
「为值语义设计 API」这节课中我会学到什么？
设计公共接口和框架时，学习如何在结构体与类之间做出选择。 你通过在浏览器中直接运行的动手代码来练习 Swift Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 Swift Academy 需要有经验吗？
无需任何先前经验。CoddyKit 上的 Swift Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 4 节课，共 4 节。
「为值语义设计 API」课时需要多长时间？
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。
我能在这节 Swift Academy 课中编写并运行代码吗？
能。每节 Swift Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。
此课程中的所有课时
- 栈与堆：值存储在哪里
- 变更、共享与意外别名
- 混合值类型与引用类型图
- 为值语义设计 API