如何编译HandyControls源代码？（官方文档已过时）

问题概述 #

编译HandyControls源码时，更换Visual Studio 2022ce后仍出现3个NETSDK1073框架引用未识别错误，已尝试常规清理恢复、多版本SDK安装等操作但无效。

排查与解决步骤 #

1. 校验VS2022工作负载完整性 #

打开Visual Studio Installer，确认已勾选**".NET桌面开发"和".NET Core跨平台开发"**工作负载，且所有组件为最新状态。完成后重启VS，避免因组件缺失导致框架引用无法识别。

2. 修正项目文件的TargetFramework配置 #

直接编辑项目的.csproj文件：

• 确保TargetFramework设置为对应版本的Windows目标框架，例如.NET 5.0的WPF项目：

<TargetFramework>net5.0-windows</TargetFramework>
<UseWPF>true</UseWPF>

• 删除手动添加的<FrameworkReference>节点，netX.X-windows会自动引入所需的Microsoft.NETCore.App和Microsoft.WindowsDesktop.App相关依赖，手动添加反而会导致冲突。

3. 清理全局NuGet缓存并重新恢复 #

执行以下命令彻底清理NuGet缓存：

dotnet nuget locals all --clear

随后在项目根目录执行：

dotnet restore

再尝试编译项目。

4. 验证SDK环境配置 #

• 执行dotnet --list-sdks，确认已安装的.NET 5.0/7.0 SDK正常显示
• 检查系统PATH环境变量，确保C:\Program Files\dotnet位于最前列，避免其他版本的dotnet路径干扰
• 确认SDK未被手动移动或修改安装路径，若路径变动需重新安装对应SDK

5. 尝试官方Powershell编译脚本 #

以管理员身份启动Powershell，切换到源码的Build目录，执行：

.\build.ps1

观察脚本输出的日志，脚本会自动处理框架依赖和编译环境，可能绕过VS的配置问题。

6. 修复Visual Studio安装 #

若以上步骤无效，打开Visual Studio Installer，选择VS2022的"修复"选项，修复损坏的安装文件，解决因组件损坏导致的框架识别异常。

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