SE-0499 深度解读:让 Swift 标准库简单协议支持 ~Copyable 与 ~Escapable 类型
SE-0499 深度解读:让 Swift 标准库简单协议支持 ~Copyable 与 ~Escapable 类型
SE-0499 是 Swift 6.4 中落地的一项标准库改造提案,它为 Equatable、Comparable、Hashable、CustomStringConvertible 等一批"简单"协议引入了 ~Copyable 与 ~Escapable 约束,使非可复制(noncopyable)与不可转义(nonescapable)类型也能参与相等性比较、哈希与字符串化。本文以 proposals/0499-support-non-copyable-simple-protocols.md 为主体,结合仓库中 SE-0390、SE-0427、SE-0446、SE-0437、SE-0527 等提案的源码级细节,讲解这些协议签名如何变更、为什么必须如此设计,以及如何在自己的类型上落地这套能力。
一、背景:~Copyable 与 ~Escapable 从何而来
要理解 SE-0499,必须先回顾 Swift 所有权(ownership)体系的三个里程碑:
- SE-0390(非可复制结构体与枚举,Swift 5.9):引入
~Copyable语法,允许struct/enum声明为非可复制(move-only)类型。此类值具有唯一所有权,不会被隐式复制,还可以声明deinit管理资源,例如文件描述符包装器。见 proposals/0390-noncopyable-structs-and-enums.md。 - SE-0427(非可复制泛型,Swift 6.0):把"可复制性"抽象为一个特殊的可抑制协议
Copyable,所有类型默认满足它,~Copyable则用于抑制这一默认一致性;非可复制类型从此可以出现在泛型参数、协议一致性乃至存在类型中。见 proposals/0427-noncopyable-generics.md。 - SE-0446(不可转义类型,Swift 6.2):对称地引入可抑制协议
Escapable(protocol Escapable: ~Copyable {}),~Escapable类型只能在局部上下文内使用,不能赋给全局变量、不能逃逸出当前作用域,为高性能的栈上分配类型(如未来的Span)铺路。见 proposals/0446-non-escapable.md。
正如 SE-0446 所强调的,Copyable 与 Escapable 彼此独立:可复制或非可复制类型都可以是可转义或不可转义的,四种组合都存在。
SE-0499 正是在这两条能力支线汇合之后,把标准库中最常用的一批协议从"必须 Copyable"的假设中解放出来。
二、动机:非可复制类型为什么需要比较、哈希与字符串化
提案的 Motivation 部分指出,标准库中有若干协议需求极其简单,并不依赖关联类型或复杂的泛型实现:
Equatable与Comparable只需**借用(borrow)**左右操作数即可完成比较;Hashable只需把借用值的哈希结果折叠进一个Hasher;- 各种字符串产生/消费操作只需借用操作数即可生成字符串(如
CustomStringConvertible.description),或者可以构造非Copyable的值(如LosslessStringConvertible.init?)。
而这些协议在 Swift 代码中无处不在,恰恰成了引入非可复制类型时的最大障碍。提案给出了一个非常具体的场景:开发者可能想用 UniqueArray(来自 swift-collections 的非可复制容器,见 proposals/0527-rigidarray-uniquearray.md)替换 Array,以省去 copy-on-write 检查带来的开销——但前提是这段代码不能依赖 Array 的 Hashable 一致性。
非可复制性的价值有两种:其一是正确性,避免一个本不该共享的值被意外共享;其二是性能,可以构建无需引用计数的、替代堆分配数据结构的实现,例如任意精度数值类型或类似 String 的类型。对这类值而言,能够互相比较是否相等是高度有用的能力——而这正是 SE-0499 要解锁的。
三、核心变更:逐条解读新的协议签名
提案给出的全部签名变更不改变任何现有语义,只是让这些协议可以被非 Copyable/Escapable 类型应用。下面按协议逐组拆解。
3.1 Equatable 与 Comparable:借用而非复制
protocol Equatable: ~Copyable, ~Escapable {
static func == (lhs: borrowing Self, rhs: borrowing Self) -> Bool
}
extension Equatable where Self: ~Copyable & ~Escapable {
static func != (lhs: borrowing Self, rhs: borrowing Self) -> Bool
}
protocol Comparable: Equatable, ~Copyable, ~Escapable {
static func < (lhs: borrowing Self, rhs: borrowing Self) -> Bool
static func <= (lhs: borrowing Self, rhs: borrowing Self) -> Bool
static func >= (lhs: borrowing Self, rhs: borrowing Self) -> Bool
static func > (lhs: borrowing Self, rhs: borrowing Self) -> Bool
}
extension Comparable where Self: ~Copyable & ~Escapable {
static func <= (lhs: borrowing Self, rhs: borrowing Self) -> Bool
static func >= (lhs: borrowing Self, rhs: borrowing Self) -> Bool
static func > (lhs: borrowing Self, rhs: borrowing Self) -> Bool
}
要点:
- 协议本身继承
~Copyable, ~Escapable,即一致性声明不再隐含要求类型可复制、可转义。 - 运算符参数全部使用
borrowing所有权修饰符——比较操作本就只需读取值,无需复制或转移所有权,这与 SE-0377 引入的参数所有权修饰符一脉相承。 - 由
==派生的!=、由<派生的<=/>=/>被放入带where Self: ~Copyable & ~Escapable约束的协议扩展中,保证派生实现同样只借用。
3.2 Hashable 与 Hasher:借用值折叠进哈希
protocol Hashable: Equatable & ~Copyable & ~Escapable { }
struct Hasher {
mutating func combine<
H: Hashable & ~Copyable & ~Escapable
>(_ value: borrowing H)
}
Hashable 继承 Equatable 并叠加 ~Copyable & ~Escapable。配套地,Hasher.combine 的泛型约束放开为 H: Hashable & ~Copyable & ~Escapable,参数同样以 borrowing 传入——哈希只需要读取值,不需要拥有它。
注意此处用 & 把 Equatable 与两个抑制约束并列书写,这是 Swift 中协议继承与能力抑制组合的标准写法,与 SE-0427 确立的语法一致。
3.3 字符串协议:Custom*StringConvertible、TextOutputStream(able) 与 LosslessStringConvertible
protocol LosslessStringConvertible: CustomStringConvertible, ~Copyable { }
protocol TextOutputStream: ~Copyable, ~Escapable { }
protocol TextOutputStreamable: ~Copyable & ~Escapable { }
protocol CustomStringConvertible: ~Copyable, ~Escapable { }
protocol CustomDebugStringConvertible: ~Copyable, ~Escapable { }
分组要点:
CustomStringConvertible、CustomDebugStringConvertible、TextOutputStream、TextOutputStreamable均标记为~Copyable, ~Escapable,因为它们只需借用操作数来生成或消费字符串。LosslessStringConvertible只标记~Copyable,刻意不标记~Escapable。提案给出的理由非常关键:允许~Escapable将要求为创建出来的值赋予一个生命周期(lifetime),这需要进一步的语言特性才能表达。而~Copyable本身已足够有价值——它允许非引用计数的任意精度数值类型从字符串中构造出来(init?(_ description: String)返回的可失败初始化器)。
3.4 组合类型:Optional 与 Result 的一致性升级
extension Optional: Equatable
where Wrapped: Equatable & ~Copyable & ~Escapable
{
public static func ==(
lhs: borrowing Wrapped?, rhs: borrowing Wrapped?
) -> Bool
}
extension Optional: Hashable where Wrapped: Hashable & ~Copyable & ~Escapable {
func hash(into hasher: inout Hasher)
var hashValue: Int
}
extension Result: Equatable
where Success: Equatable & ~Copyable, Failure: Equatable
{
public static func ==(lhs: borrowing Self, rhs: borrowing Self) -> Bool
}
extension Result: Hashable
where Success: Hashable & ~Copyable & ~Escapable, Failure: Hashable { }
Optional<Wrapped>的Equatable/Hashable一致性把约束从Wrapped: Equatable放宽到Wrapped: Equatable & ~Copyable & ~Escapable。注意Wrapped?本身是Optional<Wrapped>,==以borrowing Wrapped?传入,因此Optional包装非可复制元素时也能比较。Result<Success, Failure>中只有Success被放宽(Failure维持原约束),且Equatable一致性只要求Success: Equatable & ~Copyable,Hashable一致性则要求Success: Hashable & ~Copyable & ~Escapable。
需要说明:Optional 与 Result 本身能包装非可复制类型,是 SE-0437 已经完成的工作(该提案把 Optional<Wrapped: ~Copyable>、Result<Success: ~Copyable, Failure: ~Copyable> 泛型化,并引入 take()、泛化 ?? 运算符等,见 proposals/0437-noncopyable-stdlib-primitives.md)。但 SE-0437 明确留了一个口子:当时 Equatable 仍要求一致类型可复制,所以"包含非可复制元素的 Optional 尚不能比较相等"。SE-0499 正是补上了这一环。
3.5 字符串化入口:String.init(describing:) 与插值
extension String {
public init<
Subject: CustomStringConvertible & ~Copyable & ~Escapable
>(describing instance: borrowing Subject)
public init<
Subject: TextOutputStreamable & ~Copyable & ~Escapable
>(describing instance: borrowing Subject)
}
extension DefaultStringInterpolation
mutating func appendInterpolation<T>(
_ value: borrowing T
) where T: TextOutputStreamable & ~Copyable & ~Escapable { }
mutating func appendInterpolation<T>(
_ value: borrowing T
) where T: CustomStringConvertible & ~Copyable & ~Escapable { }
}
String.init(describing:) 的两个重载与 DefaultStringInterpolation.appendInterpolation 的对应重载,均把泛型约束扩展到 ~Copyable & ~Escapable,且参数一律 borrowing。这意味着非可复制类型可以直接参与字符串插值("\(value)")和 String(describing:),而这正是打印与调试基础设施的核心入口。
提案同时注明:带下划线(underscored)的协议需求与扩展内方法未在本文列出,但会按需同步更新。
四、实战:让非可复制类型获得 Equatable 与 Hashable
把 SE-0499 的能力组合起来,一个典型的非可复制类型可以这样声明:
// 非可复制、不可转义的轻量数值类型(示意)
struct Rational128: ~Copyable, ~Escapable, Equatable, Hashable {
var numerator: Int128
var denominator: Int128
static func == (lhs: borrowing Self, rhs: borrowing Self) -> Bool {
// 交叉相乘比较,仅借用,不复制
lhs.numerator * rhs.denominator == rhs.numerator * lhs.denominator
}
func hash(into hasher: inout Hasher) {
// 借用 self 折叠哈希
hasher.combine(numerator)
hasher.combine(denominator)
}
}
由于协议要求本身只借用操作数,这个类型不需要任何 copy-on-write 或引用计数开销就能进入 Set、Dictionary 键位等依赖 Hashable 的泛型代码。
更大规模的落地示例可参考 swift-collections 的 RigidArray/UniqueArray:SE-0527 在 proposals/0527-rigidarray-uniquearray.md 中给出的实现正是建立在 SE-0499 所铺设的基础上:
extension [Rigid|Unique]Array: Equatable where Element: Equatable & ~Copyable {
public static func ==(left: borrowing Self, right: borrowing Self) -> Bool
}
extension [Rigid|Unique]Array: Hashable where Element: Hashable & ~Copyable {
public func hash(into hasher: inout Hasher)
}
extension [Rigid|Unique]Array: CustomStringConvertible where Element: ~Copyable {
public var description: String { get }
}
extension [Rigid|Unique]Array: CustomDebugStringConvertible where Element: ~Copyable {
public var debugDescription: String { get }
}
这正是提案 Motivation 中"用 UniqueArray 替换 Array"愿景的具体兑现:只要元素满足 Equatable & ~Copyable,容器本身就能条件一致于 Equatable、Hashable、CustomStringConvertible。
五、源码兼容性与 ABI 兼容性
源码兼容:~Copyable 与 ~Escapable 的设计天然支持追溯性(retroactive)采用。没有重新陈述这些限制的扩展默认假设类型可复制、可转义,因此现有标准库客户端无需改动任何源码——除非它们主动想让代码支持更多类型。这与 SE-0427 确立的"渐进披露"(progressive disclosure)原则一致:不写 ~Copyable 的代码行为完全不变。
ABI 兼容:与以往的追溯性采用一致,标准库将沿用"逆泛型(inverse generics)"之前的既有特性来保持原有符号不变。提案同时坦承:这些协议向后部署(back deployment)的 ABI 影响仍在调查中;如果无法实现,这些新特性在 ABI 稳定的平台上可能需要用最低部署目标(deployment target)加以门槛控制。
六、未来方向:遗留的协议与后续工作
SE-0499 只是第一批,提案明确列出后续空间:
- 关联类型仍是障碍:多数未能纳入的协议(如
RangeExpression.Bound)是因为存在关联类型,而"被抑制的关联类型"(suppressed associated types)尚未成为语言特性。一旦该能力落地,可通过后续提案做类似改造(关联类型话题可参考 proposals/0503-suppressed-associated-types.md)。 Codable/Decodable:虽然没有关联类型,但其实现高度泛型化,未必能推广到非可复制类型,超出本提案范围。InlineArray与Span:既然相关协议已支持非可复制/不可转义类型,它们有望像Array一样条件一致于Hashable。其中Span的Equatable语义存在争议(InlineArray则问题不大),应留给未来提案专门讨论。- 更多
Custom*StringConvertible采用者:让Optional这类类型在Self: ~Copyable & ~Escapable条件下也符合字符串协议,需要print基础设施进一步支持,因此同样超出本提案范围。
七、备选方案:非可复制类型该不该 Equatable?
提案在 Alternatives considered 中直面了一个语义争议:可以主张非 Copyable 类型具有身份(identity),因此不该按 Equatable 现存的语义去比较。Equatable 的契约是"相等意味着可替换(substitutability)——任何两个比较相等的实例可以在任何依赖其值的代码中互换使用"。
反驳的理由同样有力,提案引用 Equatable 契约的另一半:
相等性与身份是分离的(Equality is Separate From Identity)——类实例的身份并不是实例值的一部分。
而且正如 Motivation 所述,非可复制类型的一大用途就是复刻本应被比较的类型,例如字符串或数值。一个不需要引用计数、不需要 copy-on-write 检查开销的非可复制字符串类型,当然应该能与同类比较相等。
因此最终的立场是:非 Copyable 类型的作者需要自行判断自己的类型是否应该 Equatable、相等意味着什么——标准库的职责是让"可以做到"成为可能。SE-0499 正是把这个"可能"落到了标准库的协议层。
结语
SE-0499 是 Swift 所有权模型从"类型系统层面允许非可复制"走向"标准库全面接纳非可复制"的关键一步。它没有引入任何新语法,而是精准地放宽了七个协议的约束并同步升级了 Optional、Result、Hasher、String.init(describing:) 与字符串插值入口,使 borrowing 语义贯穿比较、哈希与字符串化的全部路径。对正在构建非引用计数数据结构、追求确定性性能或希望摆脱共享所有权开销的开发者来说,这意味着非可复制类型终于可以无缝接入 Equatable/Hashable/CustomStringConvertible 驱动的既有泛型生态,也为 UniqueArray、Span、InlineArray 等下一代容器进入标准库扫清了协议层面的路障。