如何将C# Windows Forms项目升级至最新C#语言版本

直接按下面的步骤走，不用啃难懂的官方文档，我自己手头3个老WinForms项目都是这么升的，没有大问题：

• 先做过渡基线升级
  右键项目进入属性页，把目标框架切到.NET Framework 4.8，全量编译、跑通核心功能，把所有编译阶段报的过时API警告先处理完。4.8是.NET Framework的最终稳定版，和后续新版.NET的兼容性最高，这步零成本，跑不通后续升级不用试。
• 用自动化工具做主体迁移
  直接在Visual Studio的扩展管理器里搜.NET Upgrade Assistant安装，装完右键你的解决方案点升级，选「原地项目升级」，目标选当前最新的.NET LTS版本（当前是.NET 8），勾选WinForms适配选项，等工具自动跑完。工具会自动把旧的非SDK风格csproj转成新版格式、替换兼容的NuGet包、修正绝大多数API引用差异，跑完会生成一份差异报告，标红的点就是需要手动调整的内容，通常就三类：第三方控件不兼容、旧P/Invoke声明报错、配置读取逻辑差异。

  别手动改csproj做迁移，旧格式csproj带一堆GUID、全局引用配置，手动改十有八九漏东西，工具转的准确率至少90%。

• 手动修正常见问题
  1. 第三方控件：如果项目里用了旧的.NET Framework版付费/开源控件，直接替换成对应控件厂商提供的.NET 5+适配版本就行，没有适配新版的就找同功能替代，不要硬引用旧版dll，大概率出运行时崩溃。
  2. P/Invoke报错：旧代码里的Win32 API声明很多把句柄类型写成int、没写字符串封送规则，把报错的声明里的句柄参数统一换成IntPtr，补全CharSet配置就能过编译，不用改调用逻辑。
  3. 配置读取：旧的ConfigurationManager相关的App.config读取逻辑不用重写，直接装System.Configuration.ConfigurationManager这个NuGet包就能完全复用原来的代码，没必要强行改appsettings.json。
• 启用最新C#版本
  迁移到新版.NET之后，项目默认会绑定对应SDK支持的最新C#语言版本，不需要手动改配置。你可以渐进式用新语法重构旧代码：比如用空引用标注减少空指针bug、用required关键字替代重复的属性非空校验、用文件范围命名空间减少代码缩进，旧语法完全兼容，不用一次性全改。

• 避坑提示：每改完一个模块就编译跑一次核心流程，不要攒一堆问题最后一起调，很难定位根因；如果项目里有用WCF、ASMX旧服务，新版.NET有对应的兼容包，装完就能继续调用，不用重写服务层。

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