.NET 11 对维护者究竟改变了什么

体现开源维护者测试 .NET 11 升级的科技编辑工作台

.NET 11 于 11 月 10 日发布。理解它的最佳方式,是把它看作一次平台升级,而不是某个单独的 headline 功能。对开源项目维护者来说,更有用的问题是:SDK、编译器、运行时、库、构建工具和部署路径,能否在项目的真实工作流中协同运行。这一版本结合了 C# 15 的变化、更快的命令行启动、保持温热的 MSBuild 服务器、运行时改进、新的库 API,以及持续推进的 Native AOT。因此,首次评估不应只是浏览功能清单,而应从干净检出一直追踪到经过测试的产物。(.NET 11 公告)

语言层面的变化相当可观,但并不意味着必须重写代码。C# 15 加入了联合类型和封闭层次结构:一个值可以表示一组已声明情况中的一种,编译器也能检查这些备选情况是否得到处理。对于目前依赖约定、继承模式或手动维护判别器的代码库,这能让有界状态表达得更清楚。不过,是否采用该功能,仍取决于项目的语言版本策略、目标框架、公共 API 表面以及贡献者的预期。在已经稳定运行的库中,新语法可能改善内部代码,同时也会给使用者带来兼容性问题,尤其是项目需要面向多个目标构建时。

有几项变化之所以重要,是因为它们改善的是周边工具链,而不是直接修改应用代码。.NET 11 SDK 默认启用 Native AOT CLI 主机,因此 help、version 等命令可以避免启动托管 CLI。MSBuild 服务器也会在多次 CLI 调用之间保持温热,从而减少重复的启动开销。即使仓库中的应用仍面向更早的框架,这些改进也可能让本地迭代和自动化受益。因此,维护者应将安装并使用 .NET 11 SDK,与修改项目目标框架区分开来:前者是工具选择,后者会改变运行时和兼容性表面。(SDK 与运行时详情)

库的新增内容说明了这种区分为何重要。LINQ 新增了 FullJoin,以及相关的外连接和返回元组的重载;System.IO.Compression 则加入了 Zstandard API,并扩大了基于 span 的压缩支持。这些变化在合适的代码中可以替代自定义辅助方法、额外依赖或中间缓冲区。不过,在多目标包中,它们并不会自动对每个目标可用。维护者可能需要隔离较新的实现、保留旧路径,或等项目的支持矩阵使采用这些变化变得值得之后再行动。发行说明还记录了行为变化,因此,处理压缩数据、数值转换或其他底层操作的代码,应安排有针对性的回归测试。(.NET 11 库变化)

Runtime Async 是另一个应当作为可测试选择来对待的机会。在 .NET 11 中,异步挂起与恢复可以转移到运行时完成,而不再依赖编译器生成的状态机,同时还能为分析器和调试器提供更清晰的实时调用堆栈。该功能仍处于预览阶段,而且为应用代码启用它,与使用该功能构建运行时库,是两件不同的事。对维护者而言,这一区分很关键:新的运行时能力并不等于默认的迁移要求。在它成为受支持构建的一部分前,需要检查依赖项、诊断信息以及项目自身的行为。

因此,实际的基线应当保持适度而具体。使用新 SDK 构建仓库,运行平时的测试和开发命令,并测量贡献者与用户真正能感受到的操作。记录哪些收益仅来自 SDK,哪些需要重新指定目标框架,以及哪些取决于 Native AOT 等应用或发布选项。这样一来,.NET 11 就不再只是一个版本号选择,而会变成一次边界明确的兼容性实验;测试、容器和支持策略等更直观的工作流问题,则留到评估的下一阶段处理。

开发者工作流是最容易测试的升级面

对于开源维护者来说,评估 .NET 11 最快的方法,是测试仓库的日常循环:还原、构建、测试、打包,然后反复运行一个具有代表性的命令。发布公告介绍了 SDK、测试工具、基于文件的应用、移动工作流和容器发布方面的改进。这些变化无需立即将生产应用重新定位到新版本即可检查,但它们的价值取决于项目实际使用的命令和配置。微软还提醒,性能结果会因工作负载和发布模式而异,因此应把性能声明当作需要验证的假设,而不是普遍适用的保证。(.NET 11 公告)

最显眼的 SDK 变化是采用 Native AOT 的 CLI 主机。帮助和版本查询等命令可以避免启动托管 CLI,工具启动也能使用同一条低开销路径。这对短生命周期命令尤其重要,因为进程启动在总耗时中占有明显比例。应分别测量冷启动和热启动,再比较贡献者实际使用的一系列命令。大型构建仍可能主要耗费在编译和依赖处理上,而小型工具或反复执行的测试调用可能更容易体现差异。

.NET 11 默认还会让 MSBuild 服务器在 CLI 调用之间保持热状态。这使增量工作成为很有价值的测试场景:先运行两次未发生变化的构建或测试,修改一个小型源文件后,再重复比较。第一次命令用于建立状态,后续命令可能受益于服务器已经可用。不要假定 CI 运行器的表现会和开发者工作站相同,尤其是任务使用全新环境时。记录 SDK 版本、运行器类型、缓存条件和命令参数,以便复现测得的改进。

测试获得了更明确的控制选项。对于使用 Microsoft.Testing.Platform 的项目,dotnet test 增加了运行级超时、失败数量限制、更清晰的进度报告以及按模块划分的结果目录。相关开关取决于测试平台,不能与 VSTest 命令行选项互换。应在仓库实际使用的适配器、目标框架和 CI 配置下,验证测试发现、退出代码、日志、结果文件和失败行为。本地运行成功,并不能证明另一种运行器或包装脚本会以相同方式解释这些选项。

下面这个精简的工作流矩阵可以让实验保持聚焦:

工作流 检查项目 应保留的证据
CLI 启动 反复执行冷启动和热启动命令 耗时、SDK、Shell 及缓存条件
增量构建 未修改时重复运行,以及修改小型源文件后运行 构建输出和耗时
测试执行 选择、超时、失败限制和构件 运行器、日志、退出代码和结果路径
移动目标 工作负载选择和面向设备的执行 发现、部署和失败报告
容器发布 在固定输入下反复构建 镜像摘要、启动结果和已发布文件

基于文件的应用又提供了一个低风险的工作流实验。#:include 指令允许基于文件的应用跨多个源文件扩展,这可以让紧凑示例、脚本和小型命令行工具更易于维护。应结合仓库现有约定判断其收益:验证包引用、目标框架行为、生成的输出,以及 CI 使用的确切命令。入口更简单,只有在减少样板代码时才真正有用;没有证据时,不应因此重构已经成熟的多项目解决方案。

解决方案筛选工具同样适合进行实际测试。如果项目使用 .slnf 文件,就通过贡献者使用的同一套脚本和 CI 入口,运行文档规定的还原、构建和测试命令。不要只依赖成功的退出代码,而要检查实际还原、编译和测试了哪些项目。筛选器在交互式环境中有效,却被包装器或自动化任务忽略,可能造成覆盖率充足的假象。

移动端测试目标主要影响使用相应工作负载的仓库。应在受控环境中进行测试,并确认目标选择、测试发现、部署、输出以及失败报告是否正常。对于其他项目,这属于工作负载审查的一部分,不应成为升级决策的核心。容器发布也应采用同样有边界的评估方式:只有在源代码版本、SDK、基础镜像、构建参数、发布模式及其他输入都固定时,可复现的镜像摘要才有意义。比较摘要后,还要运行镜像,检查启动、配置、原生依赖和发布文件。

这一阶段的实际结论很明确:要区分默认行为与选择启用的行为,也要区分 SDK 改进与测试运行器、工作负载、项目格式或容器配置方面的要求。建立一个记录命令和输出的小分支,就能看出 .NET 11 是否改善了该仓库的工作流,以及看似明显的收益能否在维护者和 CI 实际使用的环境中保留下来。

兼容性、支持周期与安全检查应先于采用

采用 .NET 11 时,首先要问的不是它包含哪些有用的变化,而是它的支持模式和兼容性特征是否符合项目的维护周期。.NET 11 属于标准期限支持(STS)版本,支持期为两年。对于希望使用当前平台、也准备接受更短升级节奏的项目,它是一个值得考虑的选择;但这与选择长期支持路线并不是同一种承诺。对于更看重长期稳定、而不是尽早采用最新发布线的维护者来说,.NET 10 仍是 LTS 替代方案。

在修改项目目标框架之前,就应明确这一差异。开源库可能同时支持多个 .NET 版本,而应用程序或部署环境受到严格控制的工具,重新定位目标框架时可能拥有更大的自由度。因此,真正的决策并不只是“升级还是停留在原版本”,而是要判断哪个支持窗口符合项目的发布流程、用户群体,以及测试每个受支持运行时的能力。发布日程也让旧分支的规划变得紧迫:.NET 8 和 .NET 9 将于 2026 年 11 月 10 日终止支持。仍在使用这两个版本的维护者需要制定明确的迁移计划,不能假定升级总能无限期推迟。

兼容性工作应从官方 .NET 11 重大变更文档开始,然后沿着项目自身的依赖关系图展开。重新定位应用程序只是变更的一部分。运行时、SDK、包版本、测试基础设施、工作负载和部署镜像,都需要与预期的发布线保持一致。本地构建成功,仍可能掩盖测试运行器、平台工作负载,或某个依赖项目通常测试覆盖范围之外运行时行为的包所带来的不匹配。对于开源仓库,维护者还应检查持续集成矩阵和贡献者说明:如果主分支只能在维护者自己的机器上运行,那么升级就还没有完成。

.NET 11 更新了最低硬件要求,因此兼容性并不局限于源代码和包引用。在项目把升级视为例行工作之前,应检查构建代理、开发机器以及受支持的部署目标是否符合新的基线。对于发布二进制文件、提供自包含分发包,或记录大量操作系统环境的项目,这一点尤其重要。运行时升级在技术上可能完全正确,但如果较旧的硬件或操作系统组合不再可用,项目实际覆盖的用户范围仍可能因此缩小。

部署模式需要单独审查。Native AOT 和裁剪可以改善应用程序的体积或启动特性,但也会带来普通托管部署不必面对的限制。依赖动态加载、反射模式,或使用缺少必要分析信息的 API 的代码,可能需要额外处理;常规构建成功,也不能证明 AOT 发布或裁剪发布会表现相同。因此,维护者应测试实际向用户承诺的每一种部署模式,而不要把 Native AOT 兼容性视为 .NET 11 应用程序自动具备的属性。

同样的谨慎也适用于被标记为实验性的 API,包括加密和向量搜索相关功能。实验性状态意味着应将这些调用隔离在狭窄的接口之后,记录风险,并避免让它们意外成为广泛使用的公共 API 的基础。它们可能适合评估,但在采用时应考虑到:实验性表面在成为稳定的兼容性契约之前,可能仍需要调整。

最后,11.0.0 的安全修复应纳入升级评估,而不是等代码迁移完成后再单独核对。维护者应查看发布详情,确认所选 SDK 和运行时制品包含预期修复,并检查这些制品如何进入构建与容器流程。软件包缓存、固定版本的基础镜像以及自动更新规则,都可能使仓库实际使用的补丁级别不同于维护者以为已经测试过的版本。因此,实际的安全问题是:完整的构建和部署路径是否使用了已修复的发行版,而不只是项目文件是否写着 .NET 11。

在更改目标框架之前,合理的门槛是先记录支持的目标框架、操作系统、硬件假设、部署模式和依赖版本。随后,针对这份明确的矩阵运行具有代表性的应用和测试套件,尤其关注启动行为、仅在裁剪或 AOT 下出现的失败,以及文档所列破坏性变更涉及的行为。如果项目无法让这些检查保持可复现,那么为了生产稳定性,选择 .NET 10 的 LTS 路径可能更负责任;而 .NET 11 则可以保留为受控分支,用于兼容性工作和未来采用。

谁现在应该尝试 .NET 11,以及如何分阶段测试

当项目能够维护受控的兼容性分支,并且有明确理由去衡量新平台时,.NET 11 适合作为开源项目的评估对象。对于全新仓库、开发者工具、测试密集型项目,以及 CLI 启动、Native AOT、容器可复现性或运行时行为属于产品实际特征的工作负载,尤其如此。关键不在于发布版单独包含哪些吸引人的功能,而在于项目自身的构建、测试、打包和部署路径能否得到改善,同时不会增加超过收益的支持或依赖负担。

先使用分支或具有代表性的样例,不要一开始就让每位贡献者都切换默认目标。在 global.json 中固定实验所用的 SDK,避免本地机器和 CI 悄然选择不同的 SDK。记录比较中涉及的操作系统、架构、工作负载、测试运行器、容器基础镜像和部署模式。升级 SDK 与重新定位应用目标是相关但可以分开的决定:仓库可以先验证 .NET 11 工具链,同时让生产项目继续使用当前目标框架,直到兼容性证据充分。

第一轮测试应当可观测且可重复。在现有基线和 .NET 11 上,运行相同的干净构建与增量构建、重复 CLI 命令、测试套件、打包步骤以及具有代表性的应用场景。比较启动时间、内存使用、项目真正关心的吞吐量、容器镜像大小和测试可靠性。对于命令行工具,测量冷启动和重复调用路径;对于服务,则纳入启动阶段和稳定运行状态;对于库,比起单次微基准测试,更应重视构建时长、使用者样例、支持的目标框架和测试覆盖率。

将基准结果视为项目自身的证据,而不是适用于所有场景的承诺。更快的 SDK 或运行时路径,可能被缓慢的测试运行器、外部进程、网络依赖或不具代表性的工作负载掩盖。反过来,如果一项幅度不大的改进出现在每条本地命令或每次 CI 作业中,它也可能很有价值。比较时应保持相同的输入数据、配置、环境变量、硬件类别和容器流程,并保留足够的日志,以区分平台变化与日常波动。

测试必须覆盖成功的默认构建可能遗漏的路径。运行完整测试矩阵,包括使用 Microsoft.Testing.Platform 或运行器专属选项的配置,并验证筛选、诊断、覆盖率、重试和结果发布。如果仓库使用基于文件的应用、解决方案筛选器、移动测试目标、工作负载或自定义 MSBuild 逻辑,应直接测试这些入口。容器用户还应对比实际镜像流程,并核验所选镜像的引用和摘要,因为可复现性是软件供应链的一部分。

重新指定目标框架之前,应检查直接依赖包和传递依赖包、分析器、源代码生成器、测试适配器、SDK 工作负载,以及那些假定特定框架或 SDK 行为的脚本。确认 CI 镜像、托管环境和操作系统组合符合项目的支持策略。如果项目使用裁剪或 Native AOT,应测试实际发布的产物:大量依赖反射的代码、动态加载、不受支持的库以及运行时假设,都可能让“构建成功”成为不完整的信号。这些是部署环境专属的兼容性检查,并不是安装新版 SDK 后自动获得的好处。

升级决策的门槛应符合真实的维护状况。全新项目或工具链占比较高的项目,如果依赖图较小、支持环境明确,且工作流效率提升经过测量并且确实有意义,可以尽早尝试 .NET 11。成熟的生产应用则可能更适合 .NET 10,尤其是在长期支持周期和运维可预测性比采用最新 STS 版本更重要时。这是工程取舍,并不代表拒绝 .NET 11。应记录经过测试的 SDK、目标框架、部署模式、已知不兼容项,以及触发后续重新测试的条件。

在合并重新指定目标框架的变更前,应查看 .NET 11 的重大变更文档,并将每项发现归类为适用、延期处理或无关。检查运行时与软件包的版本对齐情况、.NET 11.0.0 版本中的安全修复;对于实验性的加密或向量搜索 API,在将其纳入稳定的公共契约前也要进行评估。同时还要考虑支持周期:.NET 11 属于标准期限支持,周期为两年;.NET 10 则是 LTS 替代方案。仍依赖 .NET 8 或 .NET 9 的项目,应在迁移计划中写明其支持状态,因为二者都将在 2026 年 11 月 10 日结束支持。

分阶段得出的结果,比简单的“升级或不升级”判断更有价值:固定版本并完成构建,运行完整的测试和打包矩阵,对比部署产物及经过测量的行为,然后审查兼容性、依赖项、工作负载和支持义务。如果证据积极,应先重新指定最小范围内的实际切片,扩大覆盖范围后再修改整个项目的默认设置。如果结果不一致,保留现有目标框架,同时在适当位置使用新版 SDK,可以保留学习成果,又不必强行推进尚未完成的迁移。对维护者而言,这才是 .NET 11 的真正考验:它的工具链和运行时变化能否经受仓库兼容性边界的检验,并证明值得承担相应的支持周期取舍。