Microsoft Developer
针对.NET运行时必须保留实体类型的限制,C#放弃了TypeScript式的匿名结构化类型擦除路线,转而通过基于约定的包装Struct实现兼具穷举检查与底层性能扩展的折中联合类型。
AI-assisted summary of Union types in C# | DEM304 — original source. Check the original for full context.
Source published:
Key ideas
- C# 15 将正式引入联合类型(Union Types),计划于 2026 年 11 月发布,目前已在 .NET 11 预览版、Visual Studio 预览版及 VS Code 预发布扩展中提供体验。 (0:00)
- C# 联合类型在底层默认编译为包装结构体(struct),内部使用单个 object 引用字段存储数据,并原生支持与成员类型间的隐式转换与模式匹配穷举检查(Exhaustiveness)。 (13:56)
- 为避免值类型成员在默认实现中发生装箱(boxing)内存开销,团队开放了底层模式协议;开发者可通过标注 [Union] 特性并实现指定约定的结构体,手动编写高性能无装箱实现或兼容现有代码库。 (17:54)
- 该特性历经语言设计团队约五年的探索,因 .NET 运行时依赖实体类型和反射能力,最终放弃了 TypeScript 的编译期纯结构化擦除方案,采用了居于函数式判别联合与匿名联合之间的名义化(Nominal)折中方案。 (23:42)
Detailed notes
## Background 该视频由 YouTube 频道 Microsoft Developer 于 2026 年 6 月 3 日发布,记录了微软 Build 开发者大会上的技术演示 DEM304。页面简介指出,C# 语言团队的核心成员 Mads Torgersen 与 Dustin Campbell 在现场介绍了即将引入 C# 15 的联合类型(Union Types),展示其如何优雅地为封闭数据集合建模,并在网络协议传输与业务消费中带来清晰的代码意图与类型安全。
## TL;DR 本场演讲深入展示了 C# 15 重磅引入的联合类型(Union Types)及其背后的设计权衡。Mads 与 Dustin 首先通过宠物集合与网络结果(Result/Error)两类代码场景,演示了联合类型如何消除传统基于 object 抽象的类型安全漏洞,并实现编译期的穷举性(exhaustiveness)检查与智能模式匹配。随后他们揭开了底层实现细节:编译器默认将联合类型编译为基于 [Union] 特性与 IUnion 接口的包装 struct,同时开放底层约定协议,允许开发者手动编写无装箱(no-boxing)结构或平滑迁移历史代码。最后,两位讲师复盘了长达五年的演进历程,对比了与 TypeScript 结构化联合及函数式可辨识联合的差异,并介绍了预览版的体验途径。
## Atmosphere & style 整场技术演讲节奏轻快、风趣幽默,充满了两位资深语言设计者之间默契十足的“捧哏与逗哏”互动。Dustin 负责现场写码与敏锐发问,Mads 则以语言首席架构师的视角层层剖析底层原理与历史取舍,台上关于“香肠到底是怎么做出来的”以及“开发者因编译器多报错反而更开心”的调侃令现场笑声不断。现场兼具高密度的干货输出与轻松从容的探讨氛围,让观众既能直观领略新语法的优雅便捷,又能深刻体会到语言团队历经五年探索才打磨出这套“极简折中方案”背后的工程智慧与设计温度。
## Bulletin - [00:00](https://www.youtube.com/watch?v=7qW92AwlrjM&t=0s) C# 15 将正式引入联合类型(Union Types),计划于 2026 年 11 月发布,目前已在 .NET 11 预览版、Visual Studio 预览版及 VS Code 预发布扩展中提供体验。 - [13:56](https://www.youtube.com/watch?v=7qW92AwlrjM&t=836s) C# 联合类型在底层默认编译为包装结构体(struct),内部使用单个 object 引用字段存储数据,并原生支持与成员类型间的隐式转换与模式匹配穷举检查(Exhaustiveness)。 - [17:54](https://www.youtube.com/watch?v=7qW92AwlrjM&t=1074s) 为避免值类型成员在默认实现中发生装箱(boxing)内存开销,团队开放了底层模式协议;开发者可通过标注 [Union] 特性并实现指定约定的结构体,手动编写高性能无装箱实现或兼容现有代码库。 - [23:42](https://www.youtube.com/watch?v=7qW92AwlrjM&t=1422s) 该特性历经语言设计团队约五年的探索,因 .NET 运行时依赖实体类型和反射能力,最终放弃了 TypeScript 的编译期纯结构化擦除方案,采用了居于函数式判别联合与匿名联合之间的名义化(Nominal)折中方案。
## Key takeaways - [00:00](https://www.youtube.com/watch?v=7qW92AwlrjM&t=0s) 联合类型(Union Types)是 C# 15 的重量级核心特性,旨在为离散数据集合与网络传输结果(如 Result/Error 模式)提供强类型契约保障。 - [01:16](https://www.youtube.com/watch?v=7qW92AwlrjM&t=76s) 传统面向对象中将无继承关系的多个类型抽象为 object 会导致类型安全缺失,且编译器无法验证 switch 模式匹配的分支完备性。 - [03:28](https://www.youtube.com/watch?v=7qW92AwlrjM&t=208s) 声明联合类型(如 union Pet(Dog, Cat, Bird))能够让编译器自动提供穷举检查;若 switch 分支遗漏某成员或未处理可空情况,编译器会发出警告。 - [06:28](https://www.youtube.com/watch?v=7qW92AwlrjM&t=388s) 联合类型允许在内部定义计算属性、实例方法等功能性成员,但严格禁止引入额外的实例字段或自动属性,以保证其状态纯粹对应所承载的底层数据。 - [09:42](https://www.youtube.com/watch?v=7qW92AwlrjM&t=582s) 联合类型原生支持泛型(如 Result<T>),且任何可隐式转换为 object 的类型(包括接口、记录类型 record、泛型参数)均可作为分支成员。 - [12:17](https://www.youtube.com/watch?v=7qW92AwlrjM&t=737s) 在声明联合类型的同时定义分支 record 相当于函数式编程中的可辨识联合(Discriminated Unions),支持在模式匹配中直接进行位置解构。 - [13:56](https://www.youtube.com/watch?v=7qW92AwlrjM&t=836s) 编译器默认将联合类型生成为标记了 .NET 11 [Union] 特性并实现 IUnion 接口的 struct,内部通过公开的 Value 属性和各分支类型的构造函数建立映射契约。 - [17:54](https://www.youtube.com/watch?v=7qW92AwlrjM&t=1074s) 默认实现将分支值存入 object 字段,在处理值类型时会产生装箱分配;对性能敏感的开发者可手动编写多专用字段和判别标记(tag)的结构体来消除装箱。 - [19:13](https://www.youtube.com/watch?v=7qW92AwlrjM&t=1153s) 遵循 C# 一贯基于“模式与约定”(Patterns & Conventions)的设计传统,现有遗留代码库只需标注 [Union] 并补齐约定成员即可直接接入模式匹配与穷举检查。 - [21:02](https://www.youtube.com/watch?v=7qW92AwlrjM&t=1262s) 由于 .NET 运行时依赖实体类型进行反射与动态查询,C# 无法采用 TypeScript 那样在编译后完全擦除的匿名结构化联合类型(如 dog | cat),必须采用名义化(Nominal)声明。 - [23:42](https://www.youtube.com/watch?v=7qW92AwlrjM&t=1422s) C# 联合类型类比于委托(Delegates),是在函数式严格判别联合与 TypeScript 匿名联合之间经过五年权衡得出的“折中/Goldilocks”方案。
## Detailed walkthrough ### [00:00](https://www.youtube.com/watch?v=7qW92AwlrjM&t=0s) 联合类型(Union Types)亮相 C# 15
在微软 Build 开发者大会的讲台上,C# 语言首席架构师 Mads Torgersen 与 C# 团队工程师 Dustin Campbell 共同开场。他们幽默地打趣着有限的演讲时间,宣布要在接下来的 25 分钟内重点介绍 C# 15 中即将引入的一项重量级核心特性——联合类型(Union Types)。Dustin 指出,C# 15 计划于同年 11 月正式发布,但该特性的相关内容已经在预览版中可供开发者尝鲜体验。
```mermaid flowchart TD accTitle: 各语言联合类型对比 accDescr: 对比 TypeScript、函数式语言与 C# 联合类型实现理念的流程图
subgraph OtherLangs["其他编程语言"] TS["TypeScript<br/>(结构化联合类型)"] FP["函数式语言<br/>(可辨识联合 / 标号联合)"] end
subgraph CSharp15["C# 15 特性"] CSUnions["C# 联合类型<br/>(折中/Goldilocks 方案)"] end
TS -.->|"形态各异"| CSUnions FP -.->|"语义不同"| CSUnions ```
Mads 解释称,联合类型并不是一个全新的概念,许多语言早已原生支持:例如 TypeScript 拥有灵活的联合类型,绝大多数函数式编程语言也都具备某种形式的可辨识联合(Discriminated Unions),但它们的实现方式各不相同。C# 团队并未生搬硬套已有方案,而是设计了一套契合 C# 生态与类型系统的设计,Mads 将其生动地形容为“适度平衡”的妥协版本(Goldilocks version)。正如 Mads Torgersen 所总结的:
> “They're our own little we call it Goldilocks, but you can also call it compromise version of it.”
因此,即使开发者此前在其他语言中使用过联合类型,C# 的实现也会呈现出独特的风貌;而对完全没有接触过该概念的开发者来说,也可以毫无包袱地将其视为 C# 中表达离散数据集合的标准方式。
---
[01:16](https://www.youtube.com/watch?v=7qW92AwlrjM&t=76s) 传统面向对象抽象的痛点与类型安全缺失
讲座迅速切换到代码演示环节。Dustin 展示了一段基于顶层语句(top-level statements)的现代 C# 代码,代码底部定义了一组表示动物的类型。在现实开发场景中,这些类型往往分散在不同的库中(比如独立的“狗库”和“猫库”),作者彼此互不相识,底层类型之间并不存在任何继承关系或共享接口。
当开发者试图在业务层抽象出一个“宠物(Pet)”的概念时,在现有的 C# 体系下只能退而求其次,将所有动物统一提升为顶级基类 `object`。Dustin 展示了一个包含宠物的集合 `List<object>`,并使用模式匹配的 `switch` 表达式解构各个值以生成描述信息。然而,缺乏强类型约束带来了明显的缺陷:列表中不仅混入了狗、猫、鸟,甚至还混入了一条 `Shark`(鲨鱼)。Dustin 调侃旧金山可能有人会把满口利齿的鲨鱼当宠物,但这暴露出类型系统根本无法阻止非预期数据渗入。
更为棘手的是,编译器在处理基于 `object` 的 `switch` 表达式时,根本无法验证模式匹配的完备性(exhaustiveness)。代码中会出现波浪线警告,提示开发者尚未覆盖 `object` 可能涵盖的全部情况——诸如鳄鱼、蜗牛等成千上万种类型。Mads 直言,虽然由于类型之间缺乏共同概念,以往开发者不得不写出这样的代码,但这种实现方式既笨拙又极度缺乏类型安全。
---
[03:28](https://www.youtube.com/watch?v=7qW92AwlrjM&t=208s) 声明联合类型与编译期穷举检查
为了解决这一难题,Dustin 使用全新的 `union` 关键字重构了代码,将宠物定义为一组封闭类型的联合集合:`union Pet(Dog, Cat, Bird)`。这一行简洁的声明彻底改变了类型体系:
```mermaid flowchart LR accTitle: 联合类型与类型安全转换流程 accDescr: 展示成员类型如何隐式转换为联合类型并进行完备性分支匹配
subgraph CaseTypes["联合分支成员"] D["Dog"] C["Cat"] B["Bird"] end
subgraph UnionType["联合类型 Pet"] P["Pet"] end
subgraph SwitchMatch["穷举模式匹配 (Exhaustive Switch)"] Match["switch (pet) {... }<br/>(编译器确保全部分支已处理)"] end
D -->|"隐式类型转换"| P C -->|"隐式类型转换"| P B -->|"隐式类型转换"| P P --> SwitchMatch
Shark["Shark (非法类型)"] -.->|"编译报错: 无法隐式转换"| P ```
当集合类型从 `List<object>` 改为 `List<Pet>` 后,编译器立刻精准捕获了非法输入:尝试添加 `Shark` 的代码报错“无法将类型 Shark 隐式转换为 Pet”。Mads 强调,联合类型原生支持从具体的成员类型(Case Types)隐式转换为外层的联合类型,从而在构建数据集合时自动阻断不合规的实例。
在后续对 `Pet` 执行 `switch` 表达式消费数据时,类型系统同样展现出极高的智能: - 分支中任何针对非法类型(如 `Shark`)的模式匹配都会直接触发编译错误。 - 只要匹配分支完整覆盖了联合类型中列出的所有可能情况,此前困扰开发者的完备性警告便会彻底消失。编译器通过静态推导确保了匹配的详尽无遗(exhaustive)。 - 如果开发者注释掉某一个具体分支(例如漏掉了 `Bird`),或者将分支定义为包含可空类型(如 `Bird?`)而未处理 `null`,编译器会敏锐地重新抛出警告,提示存在未捕获的分支情形。正如 Dustin Campbell 所评价的:
> “Everything that's a pet is covered by the switch. And we now get compiler support. We get compiler help to let us know that yes, we have correctly handled everything.”
---
[06:28](https://www.youtube.com/watch?v=7qW92AwlrjM&t=388s) 为联合类型添加功能性成员
Mads 和 Dustin 探讨了联合类型更深入的语法能力。虽然一行简短的 `union` 声明已经能满足绝大多数基础需求,但联合类型绝非只能作为空壳标签。开发者可以使用大括号为其扩展成员,例如将原本写在外部的数据解构与格式化逻辑直接内聚为联合类型自身的计算属性(calculated property)。
Dustin 在 `Pet` 联合类型内部声明了一个 `public` 属性 `Description`。在属性的 `get` 访问器中,可以直接针对当前实例 `this` 执行 `switch` 模式匹配,根据具体承载的子类型返回相应的描述文本。如此一来,消费端调用时便无需在外层散落冗长的 `switch` 语句,只需直接读取 `pet.Description` 即可。
关于联合类型内部成员的权限边界,Mads 给出了明确的技术约束原则:
> “We do draw a line at things that introduce more state because we think you should think of it as the state of this thing is just the actual dog or cat or bird that's inside it shouldn't have additional state, right that.”
联合类型的本质应当仅承载其内部实际包含的底层数据(无论是狗、猫还是鸟),而不允许引入任何额外的实例状态。因此: - 联合类型严禁包含会增加额外实例状态的字段或自动属性。 - 联合类型完全允许包含各种功能性成员(function members),包括计算属性、实例方法以及静态成员等。
通过这种设计,开发者既能拥有数据类型的封闭抽象能力,又能在概念内部自然封装通用的行为。
---
[08:08](https://www.youtube.com/watch?v=7qW92AwlrjM&t=488s) 迈向真实业务:模拟网络传输与结果类型(Result/Error)
在完成宠物案例的基本演示后,Dustin 反思道,语言设计团队在做功能演示时经常因为偏爱“人与学生”或“猫与狗”这类远离日常工程的示例而收到社区开发者的吐槽。为了回应真实生产开发中最迫切的诉求,他们转向了社区呼声最高的核心场景——网络传输与接口响应数据建模。
在常规的网络通信中,调用方从网络流上接收到的数据往往呈现两种互斥形态:要么是成功拿到了有效业务载荷,要么是遇到了某种错误。借助现有的 `record` 语法,Dustin 现场快速构建了两个不可变数据形态: - 一个泛型的成功载荷类型 `Success<T>`,内部携带数据 `Data`; - 一个表示失败情况的错误类型 `Error`。
虽然这些记录类型在以往的 C# 版本中早已存在,但在缺少联合类型之前,开发者很难优雅地将它们强类型关联在一起。通过 C# 15 的联合类型,编译器能够把这些本无继承关系的离散状态“胶合”为同一个封闭的强类型契约,为处理典型的数据管道与结果类型(Result Pattern)提供原生的语言级完备性保障。
[09:42](https://www.youtube.com/watch?v=7qW92AwlrjM&t=582s) 泛型联合类型与穷举匹配
Dustin Campbell 演示了如何在联合类型中使用泛型。他定义了一个名为 `Result<T>` 的联合类型,其中包含两个分支情况(cases):泛型的 `Success<T>` 与表示失败的 `Error`。借由这种建模方式,方法可以直接返回 `Result<T>`,代表其要么成功返回携带数据的结果,要么返回错误。为了模拟从网络传输(off the wire)接收数据的真实场景,Dustin 构造了一个 `Queue<Result<int>>` 队列,并向其中入队了一个包含数值 `42` 的成功对象,以及一个附带错误信息的 `Error` 对象。
```mermaid flowchart TD accTitle: 泛型 Result 联合类型与消费流程 accDescr: 展现从队列获取 Result 联合类型并通过 switch 表达式穷举解构消费数据的过程
subgraph Definition["联合类型定义"] R["Result<T>"] --> S["Success<T> (Record)"] R --> E["Error (Record)"] end
subgraph Consumption["队列消费与模式匹配"] Q["Queue<Result<int>>"] -->|"Dequeue"| Item["Result<int>"] Item --> Switch{"switch (result)"} Switch -->|"匹配 Success(d)"| Print["解构并提取数据 42"] Switch -->|"匹配 Error(msg)"| Throw["抛出异常"] end ```
随后,Dustin 编写了一个 `while` 循环不断从队列中出队结果,并利用 `switch` 语句提取内部数据。由于分支情况被定义为 `record`,开发者可以直接在模式匹配中对其进行位置解构(deconstruct),直接将成功结果中的数字绑定到变量上。当 Dustin 尚未编写错误分支的处理代码时,编译器立刻发出警告,提示缺少对 `Error` 的处理。Dustin 补充了抛出异常的错误处理逻辑并成功运行程序后,Mads Torgersen 幽默地调侃了开发团队与用户的奇妙心理:“这挺有意思的,对吧?我们的工作就是给你报更多的错,而你却因为我们给你报了更多错而喜欢我们,对吧。”(“It's funny, right? We're in the business of giving you more errors and you and you love us for giving us more, for giving you more errors, right.”)这种穷举检查让开发者能够在编译期完全掌控各种边界场景。
- 联合类型原生支持泛型,可以拥有方法与属性成员,功能上与 C# 其他常规类型一致。 - 只要能够隐式转换为 `object`,任何类型(包括接口、泛型类型参数等)都可以作为联合类型的分支情况(case types),彼此之间允许存在重叠。
[12:17](https://www.youtube.com/watch?v=7qW92AwlrjM&t=737s) 联合类型与函数式“可辨识联合”建模
Mads Torgersen 进一步深入分析了当前示例的设计哲学。他指出,当前场景与此前单纯合并已有类型的做法有着微妙的区别:这里并不是把系统中已经独立存在的类型组合起来,而是在声明联合类型的同时,全新声明了所有的分支类型。这种使用模式正是函数式编程中所称的“可辨识联合”(Discriminated Unions),即由开发者一次性对整个数据包进行完整建模,既定义了该数据可能呈现的各种形态,又通过联合类型将其牢固地封装在一起。
Mads 强调这种模式未来会成为 C# 中极其常见的使用方式。Dustin 表达了对这一语言特性的喜爱,但他随即抛出了核心疑问:“这香肠到底是怎么做出来的?”(“OK, but how is the sausage made?”)在熟悉的 C# 类型系统中,这种模式显得不可思议且神奇,如果纯手工编写通常需要大量繁杂的样板代码。对此,Mads 和 Dustin 决定揭开编译器背后的底层秘密,直接向观众展示联合类型在底层到底是如何实现的。
[13:56](https://www.youtube.com/watch?v=7qW92AwlrjM&t=836s) 拆解底层原理:基于 Struct 的实现规范
为了证明联合类型并非深不可测的黑盒,Dustin 注释掉了简洁的联合语法声明,转而通过手写其等价的展开形式来展示其底层构成。实际上,编译器生成的联合类型在底层就是一个 `struct`。为了让编译器识别普通结构体为联合类型,需要为其打上来自.NET 11 的 `[Union]` 特性。一旦加上该特性,编译器就会按照严格的规范进行校验,并引导开发者补齐缺失的成员。
```mermaid flowchart LR accTitle: 手工实现联合类型的内部结构 accDescr: 展现符合编译器规范的联合类型结构体内部包含的属性、构造函数以及实现的接口
subgraph UnionStruct["struct Result (标记 [Union])"] Prop["public object Value { get; }"] Ctor1["Result(Success<int> value)"] Ctor2["Result(Error value)"] Interface["实现 IUnion 接口"] end
Ctor1 --> Prop Ctor2 --> Prop Prop -.->|"提供统一访问"| Interface ```
根据编译器报错提示,手动构造一个合法的联合类型需要满足两个关键契约: 1. 必须公开一个名为 `Value`、类型为 `object` 的实例属性(在底层为一个后备字段,用于保存装入结构体的具体实例)。 2. 必须为每一个分支类型提供对应的构造函数(例如分别接收 `Success<int>` 与 `Error` 的构造函数),将传入的值赋给 `Value` 属性,以此在分支与联合类型之间建立绑定关系。
此外,语法糖自动生成的结构体还会实现.NET 11 内置的 `IUnion` 接口,该接口仅定义了 `Value` 属性,方便通用运行时代码在必要时执行类型检查与反射调用。Dustin 和 Mads 指出,语言团队之所以将这套底层约定公开,正是为了给予开发者突破默认行为的自由。
- `[Union]` 特性与 `IUnion` 接口已在.NET 11 预览版中提供。 - 手动编写的结构体通过构造函数参数重载来向编译器注册支持的分支类型。
[17:54](https://www.youtube.com/watch?v=7qW92AwlrjM&t=1074s) 自定义联合实现与性能极致优化
Mads Torgersen 详细阐述了允许开发者手动实现联合类型的两大核心驱动因素。首要原因在于极致的性能考量。默认语法糖生成的方案会将分支类型的值存入 `object` 类型的字段中,如果分支是两个小型的值类型(Value Types),每次构造联合时都会触发昂贵的装箱(boxing)内存分配。这在高性能或高频循环调用的场景下是无法接受的。
为了消除装箱开销,性能敏感的开发者可以选择自行设计存储结构:例如在结构体内部为每种可能的值类型分别设置专用字段,再加上一个额外的字段作为判别标记(tag)来指示当前激活的是哪个分支。Mads 解释道,虽然这种无装箱的方案从开发角度来看更为复杂,但它能彻底避免多余的内存分配;Dustin 随即打趣说反正这类繁琐的代码最后都会由 GitHub Copilot 代写。第二个原因则在于向后兼容:C# 过去二十多年一直缺乏联合类型,许多团队早已基于类继承和各种约定手写了伪联合类型,这套基于约定的设计使得老代码无需彻底推倒重来即可平滑接入新的编译器检查机制。
> “如果你不喜欢我们语法生成的默认方案——即将所有分支类型装箱到 object 字段中等等——那么主要有两个原因会让你希望采用不同的实现。”(“If you don't like our our default that our syntax generates that takes whatever case types and boxes them into an object field and so on, then they're kind of two major reasons why you might want a different implementation.” —— Mads Torgersen)
[19:13](https://www.youtube.com/watch?v=7qW92AwlrjM&t=1153s) 基于约定的模式设计与手动 Union 的底层实现机制
Mads Torgersen 和 Dustin Campbell 解释了为什么 C# 团队决定公开 Union 特性的底层协议,而不是将其封装为一个完全黑盒的编译器语法糖。如果开发者现有的代码库中早已有了自己精心优化或历史遗留的 Union 类型,C# 绝不想扮演强势的入侵者:“Now here we are with a brand new language feature and we're stomping all over you and saying, Nah, Alice is better.”(现在我们带来了一个全新的语言特性,然后直接踩在你们头上说:不行,我们的方案才更好。)相反,团队希望给开发者提供平滑迁移的路径:只需在现存类型上标注 `[Union]` 特性,并按照要求补齐几个编译器约定的成员,编译器就会将其视为合法的 Union 类型,并免费赋予其模式匹配的穷举性(exhaustiveness in the switch)以及隐式类型转换等核心语言能力。
Dustin 指出,这种设计延续了 C# 自诞生以来的深厚传统——许多核心特性都是建立在“模式”(Patterns)和“约定”(Conventions)之上的。这些约定并不严格绑定在运行时类型系统本身,而是编译器对其进行特殊识别与转换。Mads 补充道,绝大多数开发者日常其实根本不需要手动编写底层结构,但了解默认生成的结构对理解性能表现至关重要。编译器默认生成的 Union 实际上是一个包装结构体(struct),内部维护单个引用字段(a single reference field),在数据存取时根据需要进行装箱(box)与强转(cast)。
```mermaid flowchart TD accTitle: C# Union 底层实现机制与模式约定 accDescr: 展示了用户自定义约定类型与编译器默认生成的 struct 在底层与语言特性上的对应关系。
subgraph UserPath["开发者选择"] A["现有类型标注 [Union] 特性"] --> B["实现编译器约定的成员"] C["直接声明 union 语法"] --> D["默认编译为包装 struct"] end
subgraph InternalRepr["默认内部结构"] D --> E["内部单个引用字段 (Object)"] E --> F["进出时执行装箱与强制转换"] end
subgraph CompilerBenefits["编译器获得的能力"] B --> G["穷举性模式匹配 (Exhaustiveness)"] B --> H["自动隐式类型转换"] F --> G F --> H end ```
- 开发者无需抛弃现有的自定义联合类型,只需标注 `[Union]` 并满足编译器约定的方法即可接入全新模式匹配。 - 默认生成的 Union 底层是包含单一引用类型字段的 `struct`,在处理值类型分支时会发生装箱与拆箱转换。
---
[21:02](https://www.youtube.com/watch?v=7qW92AwlrjM&t=1262s) 现场互动与 TypeScript 结构化联合类型的对比思考
在进入问答环节前,两位讲师幽默地提醒听众,由于时间紧迫,现场大概只能回答一个问题,随后他们会迅速“溜”到会场外,以免打扰下一场演讲,并邀请意犹未尽的开发者移步展区绿色的开发工具展台(Experts Zone 的大立方体展位)继续深入探讨。现场一位观众站起身提问:TypeScript 和 JavaScript 中广泛存在联合类型,常用于替代方法重载来处理入参,C# 团队在设计时肯定经历了大量内部争执,能否分享一下团队内部的决策心路历程?
Mads 坦诚地承认团队曾对 TypeScript 的设计深感艳羡:“In TypeScript, union types are they're kind of structural. You don't have to declare them by name. You can just sort of cook them up on the spot.”(在 TypeScript 里,联合类型是结构化的。你不需要具名声明,可以随手捏出来,比如直接写 `dog | cat | bird` 作为参数类型。)C# 团队确实沿着这条“匿名结构化”的道路尝试过架构设计,但很快就撞上了.NET 底层运行时的现实之墙:TypeScript 的类型在编译后完全被擦除,运行时根本不存在类型实体;而在.NET 的世界里,类型必须在运行时具有明确的意义,程序必须能够在运行时对其进行反射与类型查询。
```mermaid flowchart LR accTitle: TypeScript 与 C# 联合类型设计取向对比 accDescr: 对比 TypeScript 的编译期擦除结构化联合与 C# 的运行时真实名义联合。
subgraph TypeScriptApproach["TypeScript 方案"] TS1["结构化联合 (Structural)"] --> TS2["编译期检查"] TS2 --> TS3["运行时完全擦除 (No Runtime Types)"] end
subgraph CSharpApproach["C# 5年折中方案"] CS1["名义声明联合 (Nominal)"] --> CS2["编译期全面检查"] CS2 --> CS3[".NET 运行时真实实体 (Runtime Presence)"] end ```
- TypeScript 的联合类型属于纯编译期的“结构化类型”(Structural Typing),不要求预先为联合命名。 -.NET 运行时依赖实体类型来进行动态类型检测与分发,无法采用直接丢弃类型信息的擦除机制。 - 团队未来不排除引入类似 `Union<T1, T2>` 的通用泛型库来部分找回结构化书写的灵活性,但首选必须落地为名义类型(Nominal Types)。
---
[23:42](https://www.youtube.com/watch?v=7qW92AwlrjM&t=1422s) 联合类型折中方案与预览版体验指南
Dustin 和 Mads 将当前的 Union 机制比作 C# 中的委托(Delegates):正如许多语言拥有匿名函数类型,而 C# 选择使用具名声明的委托类型一样,C# 在联合类型上也采取了名义化声明的折中策略。它既不同于纯粹匿名组合的 TypeScript,也不同于传统函数式语言中严格名义化、带有数据标签的判别联合(Discriminated Unions),而是巧妙地居于二者正中。Mads 感慨道:“We, it took us five years roughly to get to this very simple design.”(我们经历了整整大约五年的探索,才最终收敛到了如今这个看似极其简单的设计方案上。)
在演讲尾声,两位讲师展示了最后一页幻灯片并公布了相关资源的获取渠道。新特性已在 Visual Studio 预览版(配合.NET 11 预览版)中上线。如果开发者使用 VS Code,通过安装处于 Pre-release 频道的 C# 扩展插件(C# Extension for VS Code / Insiders),大约两周内就能获得演示中所呈现的全部功能支持。讲师们风趣地提醒大家当前版本尚存一些已知 Bug,但极力推荐所有开发者亲自上手试用,并前往专家展区展开后续讨论。
- C# 联合类型在函数式语言严格判别联合(Discriminated Unions)与 TypeScript 匿名联合之间找到了立足于.NET 运行时的中间地带。 - 整个特性从初期路线探索到最终语法落地,历经了 C# 设计团队长达五年的打磨。 - 支持环境包括 Visual Studio 预览版、.NET 11 预览版以及配置了预发布(Pre-release)版 C# 扩展的 VS Code。
## Mentioned C#, C# 15, Mads Torgersen, Dustin Campbell, Microsoft, Microsoft Build, TypeScript, JavaScript, .NET, .NET 11, Visual Studio, VS Code, GitHub Copilot
## Video description Union types are coming to C#! Unions model closed sets of data shapes, as commonly seen in e.g. wire protocols. Mads and Dustin explore the clean expression of intent and the confidence and elegance that unions lend to consuming code.
Seating for this session is first-come, first-served. Add it to your schedule to plan your day and arrive early to secure a spot.
To learn more, please check out these resources: * https://aka.ms/build26/DEM304 * https://aka.ms/build26/csharp/union-types
𝗦𝗽𝗲𝗮𝗸𝗲𝗿𝘀: * Dustin Campbell * Mads Torgersen
𝗦𝗲𝘀𝘀𝗶𝗼𝗻 𝗜𝗻𝗳𝗼𝗿𝗺𝗮𝘁𝗶𝗼𝗻: This is one of many sessions from the Microsoft Build 2026 event. View even more sessions on-demand and learn about Microsoft Build at https://build.microsoft.com
DEM304 | English (US) | Developer tools & frameworks
Demo | (400) Expert
#MSBuild
Chapters: 0:00 - Introduction by C# team members Mads Torgersen and Dustin Campbell 00:06:50 - Creating calculated properties and managing state 00:07:24 - Restricting unions to functional members without extra state 00:11:00 - Demonstrating exhaustive switch handling for success and error cases 00:13:56 - Explaining union type implementation using structs 00:17:54 - Performance considerations and custom union implementations 00:20:03 - Description of C# feature patterns where users can implement conventions themselves 00:20:20 - Summary of manual union writing and internal struct design for performance considerations 00:24:24 - Conclusion referencing multi-year design process and preview availability in Visual Studio and VS Code
[Source](https://www.youtube.com/watch?v=7qW92AwlrjM)