安装VS2022设备上使用Microsoft.Build库出现InvalidProjectFileException原因问询

1. NuGet包版本与MSBuild运行环境不匹配 #

你当前引用的v16.11.0版本Microsoft.Build NuGet包对应Visual Studio 2019的MSBuild工具集，原生不支持Visual Studio 2022的17.0版本工具集，也无法识别「Current」这个VS2022引入的默认工具版本标识。

2. MSBuild加载路径回退到了系统内置老版本 #

当MSBuild库找不到对应版本的工具集路径时，会自动回退到.NET Framework内置的MSBuild版本，该版本最高仅支持4.0工具版本，这就是你报错信息里仅列出「2.0", "3.5", "4.0"」三个低版本的直接原因。

你直接运行msbuild.exe正常，是因为你调用的是VS2022安装目录下的17.0版本msbuild.exe，自带完整的运行环境配置，和代码调用时的程序集加载逻辑完全不同。

ToolsVersion参数的对应规则 #

该参数是你期望调用的MSBuild工具集版本号，必须同时满足两个条件才能正常生效：

• 你引用的Microsoft.Build NuGet包版本需要大于等于该参数指定的版本
• 你的设备上实际安装了对应版本的MSBuild工具集

你当前用16.x版本的NuGet包调用17.0版本的工具集，本身就属于版本不兼容的调用方式。

方案1：适配VS2022预览版（推荐） #

1. 在NuGet包管理器中勾选「包括预发行版」，安装17.0.x预览版本的Microsoft.Build系列包，版本尽量和你设备上安装的MSBuild 17.0预览版对齐
2. 安装Microsoft.Build.Locator NuGet包，在调用任何MSBuild相关API之前，先执行以下代码完成MSBuild路径注册：

MSBuildLocator.RegisterDefaults();

3. 构造ProjectInstance时不需要手动指定ToolsVersion参数，留空即可自动匹配最新的可用版本

方案2：兼容VS2019工具集（临时过渡） #

如果暂时不想使用预览版NuGet包，可在设备上同时安装VS2019的MSBuild工具集，将项目文件的ToolsVersion修改为16.0，调用构造函数时传入"16.0"作为ToolsVersion参数即可正常运行，缺点是无法使用VS2022的新构建特性。

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