技术速递|宣布推出 .NET 11
今天,我们很高兴地宣布正式发布 .NET 11!此次年度版本让现代应用的构建更快速、更高效,并带来了对 C# 15、ASP.NET Core、.NET MAUI 和 Windows 开发的多项改进。借助数百项运行时优化、更灵敏的 SDK 工具以及更低的日常命令开销,你可以减少等待时间,把更多精力投入到创造之中。
你可以借助更丰富的 C# 语言特性、AI 编程工具和智能体能力,构建更出色的 Web 应用和跨平台应用。
.NET 11 支持周期
.NET 11 是一个标准期支持(STS)版本,将依据 .NET 支持策略提供两年的支持。STS 和长期支持(LTS)版本采用相同的质量和服务策略,两者的主要区别在于支持时长。选择任一版本时,都可以持续获得服务更新;.NET 10 仍然是受支持的 LTS 选项。
.NET 11 中的新特性
以下是我们最期待大家尝试的一些变化:
-
C# 15 的联合类型和封闭层次结构可以更清楚地表达应用可能处于的状态,并借助编译器检查模式匹配的完整性。
-
原生 AOT CLI 主机和常驻 MSBuild 服务器可以减少日常开发流程中的启动开销。
-
ASP.NET Core 新增异步验证、OpenAPI 3.2,以及面向 Blazor 和 SignalR 应用的新能力。实验性的 Blazor AI 组件可与 Agent User Interaction Protocol(AG-UI)集成,为智能体 Web 体验提供更强支持。
-
借助 Microsoft.Extensions.AI(MEAI)访问模型、借助 MCP 集成工具,并借助 Microsoft Agent Framework(MAF)构建智能体和工作流,以开发 AI 驱动的智能体应用。
-
使用面向 .NET 的 .NET Skills 获取特定指导,使用 .NET MAUI DevFlow 检查和测试运行中的应用,以及使用 .NET Upgrade canvas 查看现代化升级进度。
-
.NET MAUI 将 CoreCLR 作为默认运行时,并改进了 XAML 热重载体验和原生控件。
-
基础库新增内置 Zstandard 压缩、更简便的进程执行、更丰富的 JSON 支持,以及无需复制即可处理内存中数据的新方式。
“.NET 11 新特性”概览中提供了完整细节。下面将介绍这些变化背后的具体改进,以及如何开始使用它们。
语言
C# 15
C# 15 是面向 .NET 11 的项目默认采用的语言版本。联合类型是其中最重要的新增能力之一:一个值可以属于一组已声明的类型之一,并支持从这些类型进行转换以及在 switch 表达式中进行穷尽性检查。
例如,在产品查询中,可能会找到产品,也可能报告没有找到:
ProductLookup result = new Product(42, "Mechanical keyboard");
string message = result switch
{
Product product => $"Found {product.Name}",
ProductNotFound missing => $"No product with ID {missing.Id}",
};
Console.WriteLine(message);
public sealed record Product(int Id, string Name);
public sealed record ProductNotFound(int Id);
public union ProductLookup(Product, ProductNotFound);
返回类型会明确告诉调用方需要处理哪些结果。无需使用 object 或无关的基类,就能把这些可能的返回结果放在同一个返回类型中。
C# 15 还新增了封闭层次结构。封闭类只允许在声明它的程序集内派生,从而让编译器能够获取足够信息,对整个层次结构中的模式进行穷尽性检查。当你希望组合现有类型时,联合类型非常适用;而封闭层次结构适合由你自己管理继承关系的模型。
一些更细小的语言特性也能改善日常编码体验。集合表达式参数允许你传入构造函数或工厂方法的参数,而无需放弃集合表达式语法:
HashSet<string> names =
[with(StringComparer.OrdinalIgnoreCase), "Alice", "ALICE", "Bob"];
Console.WriteLine(names.Count);
上述代码会输出 2,因为比较器控制相等规则,所以 "Alice" 和 "ALICE" 会被视为同一个条目。
其他新增功能还包括扩展索引器,以及带标签的 break 和 continue。这些功能不要求启用预览版语言版本。独立的内存安全工作仍处于预览阶段;有关其选择启用要求,请参阅 C# 15 特性文档。
F# 11
F# 11 改进了编译器的内存使用情况,并减少了 FSharp.Core 集合操作中的内存分配。它还新增了限制并发异步工作的方法,适用于集合操作可能启动超过服务或机器可承受工作量的场景。
F# 版本说明区分了默认语言更新与预览版能力,包括面向自定义计算表达式构建器的 Runtime Async 支持。
平台
SDK
SDK 默认启用了原生 AOT CLI 主机。执行 help 和 version 等命令时,可以在不启动托管 CLI 的情况下运行;启动工具时也可以绕过托管启动路径。需要托管执行的命令仍会使用托管执行方式。
MSBuild 服务器现在也会默认在多次 CLI 调用之间保持运行状态,从而减少重复启动开销。Linux 和 macOS 上的 SDK 安装包通过程序集去重变得更小。
文件式应用可以通过 #:include 在多个源文件之间扩展,解决方案筛选器也可以直接通过 CLI 创建和编辑。dotnet watch 新增了 Aspire 应用宿主集成、崩溃恢复,以及移动项目的设备选择。
对于使用 Microsoft.Testing.Platform 的团队,dotnet test 新增了运行级超时、失败数量限制、更清晰的进度报告,以及按模块划分的结果目录。测试运行器的参数也存在差异:这些选项不能与 VSTest 命令行选项互换使用。
容器发布现在可以通过 SOURCE_DATE_EPOCH 生成可复现的镜像摘要;当目标清单已经存在时,也可以避免重复上传镜像层。NuGet 源配置新增了包最小发布时间设置,使团队可以等待一段时间,再允许新发布的包版本参与选择。这是一项附加策略控制项,不能替代漏洞检查或依赖项审查。
有关命令示例和配置方法,请参阅 SDK 和工具的新特性说明。
运行时与性能
.NET 11 的性能改进同时覆盖了你部署的代码和用于开发的工具。Stephen Toub 的 .NET 11 性能改进 详细介绍了数百项运行时和库优化,并提供基准测试和代码示例。
即时编译器(JIT)现在会删除更多冗余的边界检查和分支,改进解虚拟化,并将更多操作折叠为常量。例如,当编译时已经知道输入内容时,JIT 可以进一步优化 SequenceEqual 调用。这些改进可以直接优化生成的代码,无需重写对应的应用逻辑。
原生 AOT 接口调度现在使用共享辅助程序,减少接口调用点所需的代码,并提升接口密集型工作负载的吞吐量。硬件支持也有所扩展,包括在受支持的 x64 和 Arm64 硬件上为 Half 运算提供 FP16 指令,以及新增向量构造和组合 API。
诊断方面也有有价值的改进。在进程崩溃时,进程内崩溃报告日志可以在进程退出前捕获托管堆栈跟踪、模块信息和运行时状态。这条报告路径以前只在移动平台上提供,现在也支持 Linux 和 macOS。
与以往一样,你应该在自己的应用中实际测量其效果。吞吐量、启动时间、内存使用和部署大小取决于工作负载以及所选择的发布选项。
Runtime Async 是 .NET 11 多个预览版本中反复出现的主题。它将异步挂起和恢复过程移入运行时,不再完全依赖编译器生成的状态机。
一个特别实用的改进是:实时调用堆栈更清晰。分析器和调试器可以直接显示异步方法本身,而不是执行这些方法所使用的基础设施。这与异常堆栈跟踪有所区别:异常堆栈跟踪本来就会隐藏大量基础设施细节。
Runtime Async 仍处于预览阶段。要在以 net11.0 为目标的项目中试用,请添加:
<PropertyGroup>
<Features>runtime-async=on</Features>
</PropertyGroup>
在这种情况下,无需启用 EnablePreviewFeatures。.NET 运行时库本身已经使用 Runtime Async,但让应用代码选择新的编译模型则是独立的决定。有关行为和当前建议,请参阅 Runtime Async 文档,并在采用前测试应用的依赖项和诊断功能。
AI 库和工具
.NET 11 SDK 包含 MCP Server 模板。MCP 为 AI 应用提供了一种发现并调用工具和服务的通用方式。该模板使用官方 MCP C# SDK,并包含一个可运行的示例工具,因此你无需先安装独立模板包,就可以开始公开自己的功能:
dotnet new mcpserver -o MyMcpServer
对于调用 AI 服务的应用,Microsoft.Extensions.AI(MEAI)提供了 IChatClient 和 IEmbeddingGenerator 等抽象。这些库允许你沿用熟悉的 .NET 模式,通过依赖注入、缓存和 OpenTelemetry 组合模型访问。它们以 NuGet 包的形式提供,无需把整个应用迁移到新的框架版本即可使用。
Microsoft Agent Framework(MAF)在这些抽象之上构建智能体,使智能体能够调用工具并维护对话状态,同时协调智能体和应用代码的工作流。你可以将智能体连接到 MCP 工具,使其能够访问应用功能,也可以通过 ASP.NET Core AG-UI 终结点公开智能体,以构建交互式 Blazor 体验。AG-UI 托管集成目前处于预发布阶段。
如果要查看实践示例,可以从 .NET AI Essentials:核心构建块解析 开始,然后继续阅读 Microsoft Agent Framework 教程。
基础库
.NET 基础库新增了许多原本需要额外配置、中间缓冲区或自定义辅助程序才能实现的能力。
Process API 新增了一次性方法,可以运行进程并捕获其输出和退出状态。更高级的 API 可以控制继承句柄、挂起启动和进程信号。构建工具和开发者工具可以减少进程管理方面的代码,同时仍能检查子进程的结束状态。有关示例,请参阅 .NET 11 中的 Process API 改进。
Zstandard 压缩加入了现有的压缩格式列表,位于 System.IO.Compression 中。新的基于 span 的压缩 API 支持自行管理缓冲区的调用方;ZIP 改进还包括读取条目时的 CRC32 验证。
四个新的内存流适配器可以将现有数据桥接到接受 Stream 的 API:
-
ReadOnlyMemoryStream -
WritableMemoryStream -
ReadOnlySequenceStream -
StringStream
例如,可以直接把流水线中的分段 ReadOnlySequence<byte> 作为流读取,而无需先将其展平成新的连续缓冲区。
System.Text.Json 新增了以下支持:
-
C# 联合类型
-
F# 可区分联合
-
从异步序列输出 JSON Lines
F# 联合支持基于反射,不支持源生成、裁剪和原生 AOT。因此,在裁剪后的应用中使用该功能前,应先检查文档中列出的限制。
LINQ 新增了 FullJoin,能够保留两个输入中未匹配的元素。这对于协调类工作很有用,例如比较两份库存清单并查看任一清单中缺失的项目。
基础库还扩展了数值类型、DNS 解析、加密和跟踪配置。完整的库变更列表及仍处于实验阶段的 API,请参阅基础库概览。
Entity Framework Core 11
Entity Framework Core 11 改进了模型到查询的转换,以及查询到 SQL 的转换。
EF Core 在更多引用导航和拆分查询场景中会删除不必要的连接,改进了 GroupBy 转换,并在支持该功能的关系型提供程序上转换新的 LINQ FullJoin 运算符。这些改进可以简化生成的 SQL,同时让更多查询继续使用 LINQ 编写。
复杂类型和 JSON 列现在可以用于采用 Table-per-Type 或 Table-per-Concrete-Type继承映射的实体。其他改进还包括迁移工具以及更多特定于提供程序的 JSON 能力。
对于 SQL Server 应用,EF Core 新增了对向量索引和近似向量搜索的支持。SQL Server 功能及对应的 EF API 均处于实验阶段。评估前请查看向量搜索文档及其限制。
EF Core 11 要求使用 .NET 11。在升级时,不仅要检查数据库提供程序的兼容性和 EF Core 11 的重大变更,还要检查运行时变更。
开发者工具
新的 dotnetup 工具链管理器允许你在用户账户中安装和更新 .NET SDK 与运行时。该工具目前处于公开预览阶段,可帮助你管理并行版本并及时应用服务更新。
.NET Skills 可为编码智能体提供来自 .NET 团队的任务型指导。我们的 .NET Skills 介绍说明了如何把这些技能添加到编码智能体中。
实验性的 .NET MAUI DevFlow 工具包可以公开运行中应用的视觉树、屏幕截图和交互工具,使智能体能够检查和测试 UI,而不必只通过源代码工作。
在现代化场景中,.NET Upgrade canvas 提供了 GitHub Copilot 升级会话的可视化视图。你可以查看评估结果和依赖兼容性,跟踪实现任务,并在升级智能体工作时监控失败、进度和改动。GitHub Copilot 应用中的现代化演练覆盖了从评估到执行的完整工作流。
工作负载
Web:ASP.NET Core 和 Blazor
应用类型只有在技术栈的其余部分能够理解它们时才真正有用。ASP.NET Core 在使用 System.Text.Json 的场景中支持 C# 联合类型,包括 Minimal API 和 MVC 中的 JSON 请求体与响应体。生成的 OpenAPI 文档会使用 anyOf 架构描述联合类型的多个备选项。
这种支持适用于 JSON 请求体,不适用于路由、查询参数、请求头或表单绑定。当多个联合分支具有相同的 JSON 结构时,需要配置分类器,以便反序列化过程能够区分它们。ASP.NET Core 联合类型文档说明了这些边界。
对于需要执行 I/O 的验证规则,异步验证功能会更加实用。异步验证可以使用新的异步 DataAnnotations API,让验证器等待数据库查询或远程调用完成,而不必阻塞线程。Minimal API 和 Blazor 表单可以使用该能力。
生成的文档现在默认采用 OpenAPI 3.2。该版本还允许文档描述服务器发送事件流中每个事件的负载。如果客户端生成器或工具链的其他部分尚未支持 3.2,可以明确选择更早的文档版本。
对于长连接,SignalR 身份验证刷新允许连接刷新身份验证信息,而无需重新建立连接。Blazor Interactive Server 组件可以接收更新后的身份,并在声明发生变化时作出响应。
Blazor 同时增强了静态渲染页面和交互式应用的能力。
新的 CacheView 组件会在静态服务器端渲染期间缓存组件子树的渲染结果。缓存命中时,Blazor 会直接重放标记,不再创建子组件或执行其生命周期方法。这为页面中昂贵且基本静态的部分提供了更小粒度的缓存。
Interactive Server 应用可以选择在浏览器标签页进入非活动状态时自动暂停连接。经过可配置的延迟后,暂停会释放非活动用户占用的服务器内存和 SignalR 连接。该功能需要额外的包和显式配置;升级不会悄悄改变应用的连接行为。
表单新增了静态服务器渲染的客户端验证,以及异步验证支持。QuickGrid 和 Virtualize 新增了定位到指定项的方法,方便用户在大型集合中返回原来的位置。
Blazor 还新增了智能体用户界面组件。新的 Microsoft.AspNetCore.Components.AI 包包括流式聊天、工具渲染、审批流程和共享 UI 状态组件。基础聊天可以兼容任意 IChatClient。对于远程智能体的高级体验,AG-UI .NET 集成可以在 ASP.NET Core 智能体终结点与 Blazor UI之间传输流式响应、工具事件、审批请求和共享状态更新。
**Blazor AI 组件包属于实验性功能,在整个 .NET 11 周期内仍处于预发布状态。**它提供了一个可尝试相关方向并反馈意见的机会,但尚未成为 ASP.NET Core 共享框架中的稳定组成部分。请参阅 Blazor AI 组件文档。
AG-UI .NET SDK 介绍了该协议的客户端和服务器 API。使用新的 Blazor AI 组件构建智能体 UI 展示了如何将这些组件组合成一个可运行的应用。
有关 Blazor 功能、配置示例和兼容性详情,请参阅“ASP.NET Core 新特性”。
客户端:.NET MAUI
在 .NET 11 中,.NET MAUI 将 CoreCLR 作为所有平台的默认运行时。这一调整让移动端和桌面端应用与其他 .NET 工作负载建立在相同的运行时基础之上。在不允许 JIT 编译的 Apple 平台上,运行时会使用预编译代码和解释器,而不是在运行时生成原生代码。
原生 AOT 是一个可选择启用的发布方案;它在 Android 上的支持仍处于实验阶段。选择部署模型时,请查看平台特定的运行时指南,并测试应用的库兼容性。
UI 开发循环也进行了改进:
-
XAML 增量热重载是 .NET 11 的预览功能。它会更新页面和控件的实时实例,包括受支持的结构性编辑,无需先离开再重新导航到页面。该功能在 Debug 枚举中默认启用。
-
隐式 XAML 命名空间声明使每个文件不再需要重复声明根节点的标准命名空间。
-
Windows 平台默认使用新的
CollectionView2handler,Android Shell 则采用基于 handler 的架构。 -
新的移动测试模板和
dotnet test设备选择功能将测试纳入 CLI 工作流。
这些修改涉及运行时和 handler,因此升级时应测试导航、自定义 handler 和裁剪发布。可选的 Microsoft.Maui.Controls.Compatibility 包不再随发行版提供;仍然引用该包的应用需要迁移到替代方案。
.NET MAUI 遵循独立的支持策略,与 .NET 运行时的 STS 和 LTS 生命周期分开管理。
Windows:WinUI、Windows Forms 和 WPF
对于新的 Windows 桌面应用,WinUI 3 是推荐的原生 UI 框架。它将 C# 和 XAML 与现代控件及 Fluent Design System 结合起来。WinUI 3 通过 Windows App SDK 提供,同时该 SDK 也可以让现有的 WPF 和 Windows Forms 应用使用现代 Windows API。
要添加 UI 测试,请参阅 UWP 和 WinUI 3 应用:使用 MSTest 进行 UI 测试。
Windows Forms 在 .NET 11 中增加了可选择启用的现代视觉样式模式,可以在应用或控件级别启用。它还新增了对系统视觉和辅助功能设置作出响应、在表单准备就绪前延迟显示,以及在批量更新期间暂停绘制的能力。
这些控件让你可以在合适的位置引入更新后的视觉呈现,而无需把框架升级自动理解为完整的视觉重新设计。
WPF 更新主要聚焦可靠性,包括修复 Fluent 窗口背景、窗口管理器故障和弱事件清理问题。自包含式 Windows 发布还包含了加载混合模式 WPF 程序集时所需的原生依赖项。
开始使用并规划升级
安装 .NET 11 SDK。请使用兼容且最新的 Visual Studio 2026,或者使用 Visual Studio Code 和 C# Dev Kit。
要创建并运行控制台应用:
dotnet new console -n HelloDotnet11 -f net11.0
dotnet run --project HelloDotnet11
你可以将生成的程序替换为本文前面的任一 C# 示例,以尝试新的语言特性。
对于现有应用,请在开发环境和部署环境中统一规划升级:
-
如果仓库固定了 SDK 版本,请更新
global.json中的 SDK 选择,并在开发机和构建代理上安装匹配的 SDK。 -
将目标框架更新为 .NET 11,并在适用的情况下保留平台特定的目标框架后缀。更新包和工作负载,使它们使用兼容版本。
-
查阅 .NET 11 的重大变更,包括更新后的最低 CPU 要求。仅安装新的 SDK 并不会自动更改应用的目标框架。
-
运行测试,并在具有代表性的工作负载下测量应用性能。验证实际的发布模式、容器基础映像、原生依赖项和部署主机。
从 .NET 8 或 .NET 9 升级
.NET 8 和 .NET 9 将于 2026 年 11 月 10 日结束支持。请迁移到受支持的版本,以继续获得修复。要使用最新功能,可以选择 .NET 11;如果更适合长期支持生命周期,也可以选择 .NET 10。具体日期和服务要求请参阅 .NET 支持政策。
如果你正在从某个 .NET 11 候选发布版升级,请更新到最终版 SDK、运行时以及兼容的包和工作负载版本,不要继续停留在预发布构建上。
感谢你与我们一起构建 .NET
.NET 11 是超过 7,000 位贡献者共同努力的成果。感谢每一位贡献代码、测试预览版、报告问题并帮助我们改进设计决策的人员。在整个年度中,你们通过预览版和候选发布版提供的反馈共同塑造了今天发布的成果。
.NET 生态系统持续壮大:NuGet 上现已拥有超过 589,000 个独特包,包下载量也已超过 1.1 万亿次。
下载 .NET 11,用你熟悉的应用试用它。欢迎通过 .NET GitHub Discussions 分享你的使用结果和疑问。
更多推荐



所有评论(0)