加载旧项目到MSBuildWorkspace遇ToolsVersion错误，如何代码忽略该属性？

问题根源 #

干净的VS2022环境中，MSBuildWorkspace默认不会自动将ToolsVersion="Current"映射到当前MSBuild 17.x版本，反而会尝试查找旧工具版本（2.0/3.5/4.0），导致加载失败；而VS2022本身打开项目时会自动处理版本映射，因此能正常加载。

代码解决方案 #

无需修改项目文件，通过以下方式强制MSBuild使用VS2022的版本处理项目：

方法1：设置全局属性覆盖ToolsVersion

创建MSBuildWorkspace时，通过全局属性指定VS2022对应的MSBuild版本（17.0），替代项目中的Current值：

using Microsoft.CodeAnalysis.MSBuild;

var workspace = MSBuildWorkspace.Create();

// 订阅失败事件排查问题（可选）
workspace.WorkspaceFailed += (sender, e) => Console.WriteLine($"加载错误: {e.Diagnostic.Message}");

// 强制使用VS2022的MSBuild版本
workspace.SetGlobalProperty("ToolsVersion", "17.0");

// 可选：指定MSBuild SDK路径，确保加载正确的SDK组件
var vs2022MsBuildPath = Path.Combine(
    Environment.GetFolderPath(Environment.SpecialFolder.ProgramFiles),
    "Microsoft Visual Studio", "2022", "Community", "MSBuild", "Current", "Bin"
);
workspace.SetGlobalProperty("MSBuildSDKsPath", Path.Combine(vs2022MsBuildPath, "Sdks"));

// 加载项目
var project = await workspace.OpenProjectAsync(@"C:\YourPath\SomeProj.csproj");

方法2：使用MSBuildLocator加载正确的MSBuild实例

通过Microsoft.Build.Locator包自动定位VS2022的MSBuild，确保使用正确的版本环境：

1. 安装NuGet包：Microsoft.Build.Locator
2. 编写代码：

using Microsoft.Build.Locator;
using Microsoft.CodeAnalysis.MSBuild;

// 注册VS2022的MSBuild实例（自动检测）
MSBuildLocator.RegisterDefaults();

var workspace = MSBuildWorkspace.Create();
// 同样设置全局属性覆盖ToolsVersion
workspace.SetGlobalProperty("ToolsVersion", "17.0");

var project = await workspace.OpenProjectAsync(@"C:\YourPath\SomeProj.csproj");

原理说明 #

通过全局属性ToolsVersion强制指定为VS2022对应的MSBuild版本（17.x），让MSBuild直接使用当前环境的VS2022构建工具处理项目，和VS2022打开项目时的版本映射逻辑一致，避免查找旧工具版本的错误。

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