SE-0499 深度解读:让 Swift 标准库简单协议支持 ~Copyable 与 ~Escapable 类型

原创2026-09-22 14:51:051,813 阅读
文章标签:文档编程语言

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 等下一代容器进入标准库扫清了协议层面的路障。

登录后查看全文
swift-evolution