SuperAPI AI 工具集

migrate-dotnet10-to-dotnet11

通用与其它

查看项目

更新于 10-15 21:12

技能介绍

用途:把 .NET 10 项目或解决方案升级到 .NET 11,并系统性解决所有破坏性变更,最终得到以 net11.0 为目标、可干净构建并通过测试的项目。适用于将 TargetFramework 从 net10.0 改为 net11.0、解决升级 SDK 后的构建错误或新警告、适配 .NET 11 运行时/ASP.NET Core 11/EF Core 11 的行为变更、更新 CI/CD、Dockerfile 或部署脚本,以及修复 C# 15 编译器破坏性变更。不适用于已干净构建于 net11.0 的项目、从 .NET 9 或更早版本升级(应先处理 9→10)、从 .NET Framework 迁移,以及直接以 .NET 11 起步的新项目。

主要能力:按步骤评估项目、更新目标框架、修复源码级与编译变更、处理行为变更、更新基础设施并验证。输入包括项目或解决方案路径(必需)、构建命令、测试命令、项目类型提示(可选,可自动检测)。

使用方式:先运行 dotnet --version 确认已安装 .NET 11 SDK,否则停止并告知用户;检查 SDK 属性与 PackageReferences 判断所用技术领域;在 net10.0 上做干净构建建立基线。随后在 .csproj 或 Directory.Build.props 中把 <TargetFramework>net10.0</TargetFramework> 改为 <TargetFramework>net11.0</TargetFramework>,多目标项目在 <TargetFrameworks> 中加入或替换 net11.0,并把 Microsoft.Extensions.、Microsoft.AspNetCore.、Microsoft.EntityFrameworkCore.* 等包更新到 11.0.x,然后运行 dotnet restore 与 dotnet build。按技术领域加载 references/ 下的参考文档(csharp-compiler、core-libraries、sdk-msbuild 始终加载;aspnetcore、efcore、cryptography、runtime-jit 按需加载),逐项修复构建错误。再处理行为变更,更新 Dockerfile 基础镜像(sdk:11.0、aspnet:11.0)、CI/CD 与 global.json 中的 sdk.version,最后运行 dotnet build --no-incremental 与 dotnet test 验证。

限制:.NET 11 目前为预览版,仅覆盖至 Preview 3 的破坏性变更;破坏性变更信息以已加载的参考文档为准,不应抓取网页等外部来源;若未安装 .NET 11 SDK 则无法继续。具体命令、包版本与配置细节以资料为准,其余未提供。