Swift 标准库 Identifiable 协议深度解析:从 SE-0261 提案到 SwiftUI 与泛型编程实践
Swift 标准库 Identifiable 协议深度解析:从 SE-0261 提案到 SwiftUI 与泛型编程实践
Identifiable 是 Swift 标准库中用于表达"实体稳定身份"的核心协议,它由 SE-0261 提案 引入并于 Swift 5.1 实现。本文以该提案为骨架,结合仓库内后续相关提案(SE-0319、SE-0358、SE-0309、SE-0494),完整梳理 Identifiable 的动机、设计细节、默认实现、演进历程与实践写法,帮助你在 diff 算法、用户界面库与通用泛型代码中正确建模实体身份。
一、为什么需要 Identifiable:实体身份与状态快照的分离
许多场景都需要把"不同的值"判定为"同一个逻辑实体"。提案用一个典型的 Contact 记录来说明:
struct Contact {
var id: Int
var name: String
}
let john = Contact(id: 1000, name: "John Appleseed")
var johnny = john
johnny.name = "Johnny Appleseed"
john 与 johnny 指向同一个人:虽然名字(状态)在变化,但 id(身份)始终不变。能够在任意时刻判断"两个快照属于同一逻辑实体",是一项通用且基础的能力。
把身份简单地表示为类实例的 ObjectIdentifier(或直接用 ===)有时可行,但并非普适:当实体需要被持久化、或在多个进程间分布式存在时,对象标识符根本不可用;即便可用,为了表达值类型的身份而去分配类实例也"代价不必要地高昂"(needlessly costly)。Identifiable 正是把"身份"从"状态"中抽象出来的标准答案。
1.1 Diff 场景:UI 更新与模型层解耦
用户界面常常由代表实体的元素集合构成,例如一个收藏联系人列表:
struct FavoriteContactList: View {
var favorites: [Contact]
var body: some View {
List(favorites) { contact in
FavoriteCell(contact)
}
}
}
要在新内容到达时提供高质量的用户体验,UI 必须区分"实体的身份"与"实体状态的表示":身份未变、仅状态变化的实体,其 UI 内容应就地更新,而不是删除旧内容再插入新内容。只要列表元素是 Identifiable 的,UI 组件就能做出这种区分:
struct List {
init<Data: Collection, RowContent: View>(
_ data: Data,
@ViewBuilder rowContent: @escaping (Data.Element) -> RowContent
) where Data.Element: Identifiable
}
Identifiable 支撑的 diff 算法能够报告实体的插入、移动与移除,也能检测"在两个集合中都存在"的实体的状态变化——包括状态变化与位置移动同时发生的情况。
提案特别强调:diff 不必非在 UI 层执行。在模型层计算 diff 有明确收益——模型层更新可以在后台线程处理、切回主线程前先算好 diff 再应用;当同一份数据在 UI 中同时有多个呈现时,在 UI 层重复计算 diff 是冗余的。而模型层代码通常只依赖标准库本身,不愿为自定义的 Identifiable 变体引入对某个 UI 框架的依赖;如果标准库不定义 Identifiable,各框架各自定义、互不兼容的变体就会在依赖栈上层叠加,程序员不得不维护自己的版本并保证其能与其他框架中的类似定义共存。这正是把 Identifiable 移入标准库的根本动机。
二、方案设计:协议定义与最小约定
提案提出的解决方案是定义一个全新的 Identifiable 协议:
/// A class of types whose instances hold the value of an entity with stable identity.
protocol Identifiable {
/// A type representing the stable identity of the entity associated with `self`.
associatedtype ID: Hashable
/// The stable identity of the entity associated with `self`.
var id: ID { get }
}
协议只要求两件事:
- 一个关联类型
ID,且约束为Hashable(保证身份可比较、可哈希,可用于集合键与 diff 匹配); - 一个只读属性
id: ID,返回实体稳定身份。
一个简单的一致性示例:
struct Contact: Identifiable {
var id: Int
var name: String
}
为什么 ID 是关联类型而非固定类型? 选择身份的表示方式需要权衡多种因素:值语义或引用语义、是否持久化、是否分布式、性能、便利性等。不存在一个在所有情况下都合适的单一具体标识符类型,因此 ID 作为关联类型交由每个具体类型自行决定。
为什么用 id 而不是全写 identifier? 提案指出,id 是(Swift 社区中)被频繁使用的约定俗成术语(term of art),采用它可以让类型更容易地声明一致性。这一决策在后续实践中被大量印证——见下文 SwiftUI、actor 与标准库自身的应用。
三、详细设计:类实例的默认实现与自定义
3.1 对象的可识别性(Object identifiability)
为了让类类型尽可能方便地遵循 Identifiable,提案为所有类实例提供默认的 id 实现:
extension Identifiable where Self: AnyObject {
var id: ObjectIdentifier {
return ObjectIdentifier(self)
}
}
于是,一个靠对象身份来区分的类无需显式提供 id:
final class Contact: Identifiable {
var name: String
init(name: String) {
self.name = name
}
}
注意:ObjectIdentifier 满足 Hashable,因此 ID 被自动推断为 ObjectIdentifier。对于以对象标识为身份的类,这提供了"零成本"的一致性。
3.2 类也可以自定义 id
类同样可以覆盖默认实现,提供自定义的 id(例如来自持久化存储的整数主键):
final class Contact: Identifiable {
let id: Int
let name: String
init(id: Int, name: String) {
self.id = id
self.name = name
}
}
3.3 演进补充:主关联类型(SE-0358)
由于 ID 是 Identifiable 唯一的关联类型,它在 SE-0358 提案 中被标记为主关联类型(primary associated type),使得轻量语法 some Identifiable<String> 成为可能(见该提案中的协议清单表格,Identifiable 的主关联类型列为 ID)。该提案还以 "Identifiable by String" 作为"关联类型与协议关系可用简单介词描述"的教科书级例子——这从标准库层面印证了 Identifiable 的关联类型设计是清晰、直觉的。
3.4 演进补充:Never 的 bottom-type 一致性(SE-0319)
SE-0319 将 Never 遵循 Identifiable,使其可以作为要求 Identifiable 的泛型约束下的"底类型(bottom type)":
@available(macOS 12.0, iOS 15.0, watchOS 8.0, tvOS 15.0, *)
extension Never: Identifiable {
public var id: Never {
switch self {}
}
}
其动机与 SE-0215(Never: Equatable, Hashable)一脉相承:在 SwiftUI 的 TableRowContent 这类"递归类型模式"中,需要一个 Identifiable 关联类型的原始底类型(public typealias TableRowValue /* conforms to Identifiable */ = Never)。SE-0319 同时指出:若其他模块已自行声明 Never: Identifiable,编译器会发出警告("conformance of 'Never' to protocol 'Identifiable' was already stated in the type's module 'Swift'"),并改用标准库的一致性——由于 Never 的实例无法构造,这种替换没有可观察差异。
四、兼容性与稳定性
提案对兼容性给出了三项结论,均指向"纯增量、零破坏":
- 源码兼容(Source compatibility):这是纯粹的增量改动(purely additive change);
- ABI 稳定性:同样是纯增量改动,不影响既有 ABI;
- API 韧性(API resilience):不会带来超出其他语言特性已覆盖范围的任何影响。
这意味着任何 Swift 5.1 及以后的代码都可以安全地引入 Identifiable,不必担心破坏既有源码或二进制兼容。
五、被否决的替代方案:为什么"每个使用点传 id"不好
5.1 按使用点传标识(Per-use identification)
另一种思路是:不让集合元素约束为 Identifiable,而是在使用点额外传入一个"从实体投影出身份"的参数:
struct FavoriteContactList: View {
var favorites: [Contact]
var body: some View {
List(favorites, id: \.id) { contact in
FavoriteCell(contact)
}
}
}
struct List {
public init<Data: Collection, ID: Hashable, RowContent: View>(
_ data: Data,
id: KeyPath<Data, ID>,
@ViewBuilder rowContent: @escaping (Data.Element) -> RowContent
)
}
提案认为这种方式不可取,理由有二:
- 一个类型通常只有唯一的、规范的(canonical)身份,而"按使用点传 id"会在每个使用处重新定义实体的身份,容易出错;
- 它不是一个实际的替代方案——有证据表明,如果 Swift 不定义
Identifiable概念,各库更倾向于自行定义协议变体,而不是在使用点接收一个标识符。
5.2 具体类型的直接遵循(Concrete conformances)
UUID、Int、String 这些具体类型经常被用作标识符,但它们本身并不拥有一个标识符("they do not have an identifier")。Identifiable 的目的是区分"实体的身份"与"实体的状态",因此这些类型不应遵循 Identifiable。这也是一个重要的设计边界:遵循 Identifiable 意味着该值代表某个具有稳定身份的实体,而非该值本身可哈希。
六、未来方向与仓库中的后续演进
6.1 集合 diffing(Collection diffing)
提案当时为聚焦范围,未把集合 diffing 的便利 API 一并纳入。彼时标准库已有基于 Equatable 的集合 diff 便捷方法:
extension BidirectionalCollection where Element: Equatable {
func difference<C: BidirectionalCollection>(
from other: C
) -> CollectionDifference<Element> where C.Element == Self.Element
}
理想情况下,可以为 Identifiable 元素提供类似的便捷方法(并且在类型同时遵循两者时优先使用 Identifiable 而非 Equatable)。这一方向与 SE-0494 的思路一脉相承——后者在讨论"按值相等做记忆化有 O(n) 性能瓶颈"时,正是以 SE-0261 的 Contact 模型为例展开的:
struct Contact: Identifiable, Equatable {
let id: Int
var name: String
var isFavorite: Bool
}
并配套了 SwiftUI 视图组件中通过 Contact.ID? 管理选中状态(@State private var selection: Contact.ID?)的用法——这是 Identifiable 关联类型 ID 在实际工程中的直接应用。
6.2 条件遵循(Conditional conformances)
提案还设想为 Optional 提供条件遵循 Optional: Identifiable where Wrapped: Identifiable,同样因聚焦范围而暂缓。
6.3 与泛型系统演进的互动
- SE-0309 以
Identifiable作为"带关联类型需求"协议的代表性例子(public protocol Identifiable { associatedtype ID: Hashable; var id: ID { get } }),指出带关联类型的协议此前无法作为存在类型(existential)使用,并讨论了protocol Animal: Identifiable where ID == String这类精化协议的行为; - SE-0469 展示了 actor 场景下的应用:actor 可用常量
let属性实现id需求(actor Worker: Identifiable),且 distributed actor 已隐式遵循Identifiable,其id由管理它的 actor 系统分配,成为日志与 trace 中人类可读的 actor 身份表示。
七、实践要点总结
| 关注点 | 结论 |
|---|---|
| 身份与状态 | id 只表达"是谁",状态变化(如改名)不改变 id |
ID 的选择 |
关联类型而非固定类型;持久化/分布式实体用 UUID 或数据库主键,本地对象可用默认 ObjectIdentifier |
| 类类型的便利 | extension Identifiable where Self: AnyObject 提供默认 id,类可不写实现直接遵循 |
| 值类型 | 必须显式提供 id(如 struct Contact: Identifiable { var id: Int ... }) |
| 不要做的事 | Int/String/UUID 本身不遵循 Identifiable;不要在每次使用点用 keypath 临时定义身份 |
| 泛型约束 | ID 是主关联类型(SE-0358),可写作 some Identifiable<Int>;Never 可作为"底类型"占位(SE-0319) |
Identifiable 虽只有两行协议声明,却定义了 Swift 生态中"身份建模"的统一语言:SwiftUI 的 List/ForEach、diff 算法、actor 与 distributed actor 的身份表示、泛型约束与存在类型演进,全都建立在这个最小的契约之上。设计一个足够小而正确的抽象,其影响可以远超一次 API 提案本身——这正是 SE-0261 留给后续版本与整个标准库的遗产。