Visual Studio 17.5.0中无法打开使用WeifenLuo.WinFormsUI.Docking的窗体

可能的根本原因 #

• VS 17.5.0默认搭载了.NET 7 SDK，即便项目目标框架是.NET 6，WinForms设计器仍可能优先调用.NET 7 SDK加载控件，而旧版本的WeifenLuo.WinFormsUI.Docking库对.NET 7 SDK的设计器环境兼容性不足，导致加载失败。
• VS 17.5对WinForms设计器做了底层更新，旧版本的Docking控件库未适配这些变更，引发设计器加载异常。

可行的解决办法 #

• 锁定项目使用的.NET SDK版本：在项目根目录创建global.json文件，强制项目使用.NET 6 SDK（替换为你已安装的.NET 6 SDK具体版本号）：

  {
    "sdk": {
      "version": "6.0.408",
      "rollForward": "disable"
    }
  }
  

  保存后重新加载项目，设计器会用指定的.NET 6 SDK加载控件。

• 更新WeifenLuo.WinFormsUI.Docking库：打开NuGet包管理器，将该库更新到最新稳定版本。多数控件库维护者已针对.NET 7和VS 17.5+做了兼容性修复，更新后大概率能解决设计器加载问题。

• 清理VS和项目缓存：

  • 删除项目目录下的bin和obj文件夹；
  • 关闭VS，删除%LOCALAPPDATA%\Microsoft\VisualStudio\17.5_*\ComponentModelCache目录下的缓存文件；
  • 重新打开VS并加载项目，尝试打开窗体设计器。

• 调整VS的SDK默认设置：打开VS的「工具」->「选项」->「项目和解决方案」->「.NET Core」，将「默认SDK版本」设置为已安装的.NET 6 SDK版本，重启VS后生效。

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