SuperAPI AI 工具集

dotnet-version-upgrade

通用与其它

查看项目

更新于 10-16 02:33

技能介绍

用途:指导 .NET 项目升级到更新的目标框架(TFM),消费 dotnet-version-detection 输出的当前 TFM、SDK 版本与预览标志,给出可执行的升级步骤。

主要能力:提供三条升级路线。生产路线(默认)net8.0 -> net10.0,LTS 到 LTS,风险低;分阶段生产路线 net8.0 -> net9.0 -> net10.0,适用于依赖要求中间版本时;实验路线 net10.0 -> net11.0(预览),仅限非生产探索。覆盖 TFM 迁移清单、包更新策略(dotnet-outdated、中央包管理)、破坏性变更检测(构建期、分析器诊断、API diff 工具)、.NET Upgrade Assistant 使用、弃用 API 替换与测试验证。

使用方式:更新 .csproj 或 Directory.Build.props 中的 TargetFramework,更新 global.json 的 SDK 版本;用 dotnet tool install -g dotnet-outdated-tool 安装后运行 dotnet outdated 或 dotnet outdated --upgrade --version-lock major 更新包;用 dotnet build --warnaserror 与 dotnet test --configuration Release 验证;大型解决方案可用 dotnet tool install -g upgrade-assistant 后执行 upgrade-assistant analyze 或 upgrade-assistant upgrade。

适用场景:.NET 应用与库的版本迁移、依赖兼容性排查、弃用 API 替换、预览特性评估。

限制:不负责 TFM 检测(见 dotnet-version-detection)、多目标与 polyfill(见 dotnet-multi-targeting)、云部署与 CI/CD 变更。Upgrade Assistant 无法处理全部破坏性变更,仍需人工审查与测试。预览 SDK 不得用于生产。.NET 9 为 STS,支持至 2026 年 5 月,不应停留。具体价格与平台信息暂未提供。