好问题！其实不用严格跟着官方文档一步步升级到每个小版本，这里给你梳理下可行的迁移方案，帮你少走弯路：

理论上是可以尝试的，但非常不推荐。因为ASP.NET Core 1.0到3.1的跨度实在太大了——项目结构、Startup.cs的核心逻辑、配置系统、中间件模型、依赖注入机制都有大量Breaking Changes。直接跳的话，你需要一次性处理所有版本间的API变更、弃用项、配置差异，调试起来会异常头疼，很容易陷入一堆编译和运行时错误里找不到头绪。

这个路径会轻松很多，也是我更推荐的方案。原因是：

• .NET Core 2.2是2.x系列的最后一个版本，和1.0的兼容性比3.1好不少，迁移时需要处理的变更相对集中
• 2.x到3.x的迁移文档非常清晰，官方对这一步的Breaking Changes总结得很到位，你可以集中精力处理这部分差异

第一步：从1.0迁移到2.2 #

• 修改项目文件（.csproj）：把<TargetFramework>改成netcoreapp2.2
• 更新NuGet包：将所有Microsoft.AspNetCore相关的包升级到2.2版本，注意替换掉已被弃用的包（比如1.0里的Microsoft.AspNetCore.Server.IISIntegration需要换成新版的对应包）
• 调整Startup.cs：
  • 2.x里UseMvc()的配置逻辑有变化，你可以根据项目类型（MVC、Web API、Razor Pages）选择AddControllersWithViews()、AddControllers()或AddRazorPages()来替代原来的AddMvc()
  • 中间件的注册顺序和用法可能需要调整，比如静态文件、认证授权中间件的位置
• 重构配置系统：2.x支持更简洁的配置方式，你可以在Program.cs里用CreateDefaultBuilder()来替代1.0里手动构建ConfigurationBuilder的逻辑
• 修复编译错误：处理API命名空间变化、方法参数调整、弃用警告等问题

第二步：从2.2迁移到3.1 #

• 修改项目文件：将<TargetFramework>改成netcoreapp3.1
• 升级NuGet包：ASP.NET Core 3.1引入了Microsoft.AspNetCore.App元包，大部分零散的AspNetCore包都可以合并到这个元包里，不需要单独引用
• 重构Startup.cs：
  • 3.x强制启用了端点路由（Endpoint Routing），原来的UseMvc()需要替换成UseEndpoints()来配置路由规则
  • ConfigureServices里的AddMvc()要换成对应项目类型的注册方法（比如AddControllers()用于Web API）
• 调整依赖注入：部分服务的注册方式有变化，比如AddDbContext的配置参数
• 处理过时API：比如认证授权中间件的顺序、某些中间件的用法变更
• 检查第三方库：确保所有第三方NuGet包都支持netcoreapp3.1，不支持的话需要找替代方案或升级到兼容版本

• 迁移前一定要备份项目，或者用Git创建专门的迁移分支，避免改崩了没法回滚
• 先迁移一个小的测试项目或者次要模块，熟悉流程后再动主项目
• 利用Visual Studio的自动迁移工具：VS里有项目迁移的选项，可以帮你自动更新部分配置和NuGet包，减少手动工作量

内容的提问来源于stack exchange，提问作者ashilon