dotnet/skills .NET 9升10迁移实战升级要点与回归检查清单【免费下载链接】skillsRepository for skills to assist AI coding agents with .NET and C#项目地址: https://gitcode.com/GitHub_Trending/skills17/skills在 .NET 10 发布后把存量项目从net9.0升到net10.0往往不是改个版本号那么简单C# 14 编译器、EF Core 10、ASP.NET Core 10、SDK 与 NuGet 都引入了破坏性变更。本仓库.NET Agent Skills即 dotnet/skills由 .NET 团队维护其中的 migrate-dotnet9-to-dotnet10 迁移技能把整套升级流程沉淀为可复用的清单与参考资料下面带你走一遍这套 .NET 9升10迁移实战要点并附一份可落地的回归检查清单。上图为该仓库技能评估体系的运行结果示例迁移类技能通过带技能 vs 无技能的对照评测来验证质量这也是清单背后可靠性的来源。一、迁移技能是做什么的plugins/dotnet-upgrade/ 插件专注 .NET 项目跨版本迁移核心入口是 migrate-dotnet9-to-dotnet10/SKILL.md。它的工作方式可以概括为适用范围net9.0→net10.0的框架升级、升级 SDK 后的编译报错与新告警、行为变更适配、Dockerfile 从 Debian 切换 Ubuntu 基础镜像、System.Linq.Async迁移到内置AsyncEnumerable等不适用.NET Framework 迁移、从 .NET 8 或更早版本起步应先用 migrate-dotnet8-to-dotnet9 先到net9.0配套参考资料references/ 目录下按技术领域拆了 10 份文档C# 编译器、核心库、SDK/NuGet、ASP.NET Core、EF Core、加密、序列化/网络、容器互操作等按需加载避免信息过载。二、六步迁移工作流速览技能定义的流程非常清晰可直接作为你自己的升级执行顺序步骤目标关键动作1️⃣ 评估项目建立基线确认 .NET 10 SDK 已安装干净构建当前net9.0并记录既有警告2️⃣ 更新目标框架切到net10.0修改TargetFramework同步升级 Microsoft 官方包到 10.0.x3️⃣ 解决编译错误清零报错按技术领域加载对应参考文档逐批修复4️⃣ 处理行为变更防运行时翻车检查能编译但行为变了的项5️⃣ 更新基础设施容器与 CIDockerfile、global.json、环境变量6️⃣ 验证全量回归干净构建 全量测试 冒烟 安全审查建议在每个逻辑边界提交一次代码改完 TFM、修完报错、处理完行为变更、更新完基础设施各一次便于回滚和评审。更新框架版本时要盯住的 NuGet 新行为执行dotnet restore时.NET 10 的 SDK 会带来几个容易踩雷的变化详见 sdk-msbuild-dotnet9to10.mdNU1510 警告包已被共享框架包含NuGet 剪掉了你的直接引用 —— 按提示移除多余的PackageReference即可缺少 Version 的包引用直接报错每个引用都必须带版本号或启用中央包管理传递依赖漏洞审计restore 时会自动审查传递包的已知漏洞新出现的告警要逐条处理而不是忽略。三、五大高频破坏性变更以下是最常见的拦路虎完整细节见 SKILL.md 与 csharp-compiler-dotnet9to10.mdC# 14 关键字冲突field成为属性访问器内的上下文关键字属性访问器里恰好叫field的局部变量会直接报编译错误重命名如fieldValue即可类型为extension的命名同理受限。Span 重载改变绑定表达式树中对数组调用Contains()、Reverse()可能解析到新的 Span 扩展方法而非 Enumerable 版本典型修法是显式调用Enumerable.XXX或转为IEnumerableT。五枚新弃用警告SYSLIB0058–SYSLIB0062涉及SslStream密码套件属性、Rfc2898DeriveBytes构造函数、Queryable.MaxBy/MinBy重载等都有明确的新 API 替代方案。运行时行为变更运行时不再默认注册 SIGTERM 处理器 —— 容器化的控制台应用要手动注册PosixSignalRegistrationBackgroundService.ExecuteAsync的首段同步代码不再阻塞启动涉及启动顺序的初始化要挪到StartAsync配置绑定开始保留 JSONnull不再转空字符串依赖空串兜底的代码要复查。EF Core 10 重点SQLite 的DateTimeOffset时区处理整体改为 UTC 语义高影响可用 AppContext 开关临时回退集合.Contains()查询从 JSON 方式改为多标量参数大集合要关注查询性能。四、回归检查清单可直接对照执行升级完成后逐项打勾干净构建通过dotnet build --no-incremental无新增警告全量测试通过dotnet test优雅停机/信号处理行为符合预期后台服务启动顺序无异常含null值的配置绑定结果正确日期时间处理尤其 SQLite 场景语义符合预期多态类型的 JSON 序列化不再因属性名冲突而抛异常安全项TLS 密码校验逻辑在SslStream迁移后保持等价安全项标记[Obsolete]的敏感属性已加[XmlIgnore]/[JsonIgnore]防止意外序列化曾以Uri长度做入参拦截的补上显式长度校验dotnet restore的漏洞审计发现已处理而非被抑制五、基础设施与 CI/CD 同步升级Dockerfile基础镜像默认从 Debian 切换到Ubuntu且 .NET 10 不再提供 Debian 镜像apt-get相关安装命令可能需要同步调整参见 containers-interop-dotnet9to10.mdglobal.json / CI 脚本SDK 版本号更新到 10.0.x注意dotnet new sln现在默认生成.slnx格式脚本依赖旧格式要加--format sln环境变量改名DOTNET_OPENSSL_VERSION_OVERRIDE、DOTNET_ICU_VERSION_OVERRIDE旧名已失效NUGET_ENABLE_ENHANCED_HTTP_RETRY被移除重试已默认开启OpenSSLUnix 平台要求 1.1.1macOS 不再支持 OpenSSL 密码原语。六、延伸阅读SKILL.md.NET 9 → .NET 10 完整迁移流程core-libraries-dotnet9to10.md核心库破坏性变更aspnet-core-dotnet9to10.mdASP.NET Core 变更含 OpenAPI v2 重构efcore-dotnet9to10.mdEF Core 10 变更eval.yaml覆盖 13 类真实迁移场景的评估用例 —— 从System.Linq.Async冲突、SIGTERM 处理到 SQLite 时区语义可以当作疑难杂症自检库对照排查从 .NET 8 起步的项目请先阅读 migrate-dotnet8-to-dotnet9/SKILL.md升级到net9.0后再执行本文流程 提示把仓库里的迁移技能安装给你的 AI 编码助手后直接描述项目情况即可获得按领域定制的修复建议即使不用 AI上述清单与 references 文档也是独立可用的迁移地图。【免费下载链接】skillsRepository for skills to assist AI coding agents with .NET and C#项目地址: https://gitcode.com/GitHub_Trending/skills17/skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
