如何在.NET Core项目中使用Microsoft.Build？构建.vcxproj遇类型加载异常求助

一、如何在.NET Core项目中使用Microsoft.Build #

要在.NET Core里以编程方式操作MSBuild，跟着这几步走就好：

1. 安装必要的NuGet包
   先添加核心依赖包（务必保证所有MSBuild相关包版本一致，建议用最新稳定版）：

   dotnet add package Microsoft.Build
   dotnet add package Microsoft.Build.Framework
   dotnet add package Microsoft.Build.Utilities.Core
   

   如果要构建C项目（.vcxproj），还得额外安装C专属的构建任务包：

   dotnet add package Microsoft.Build.CPP.Tasks
   

2. 基础使用示例
   下面是一个加载并构建项目的简单代码片段：

   using Microsoft.Build.Evaluation;
   using Microsoft.Build.Execution;
   
   var projectPath = @"C:\Your\Project\Path\Demo.vcxproj";
   var globalProperties = new Dictionary<string, string>
   {
       { "Configuration", "Release" },
       { "Platform", "x64" }
   };
   
   // 用指定的全局属性创建项目集合
   using var projectCollection = new ProjectCollection(globalProperties);
   var project = projectCollection.LoadProject(projectPath);
   
   // 执行构建
   var buildParams = new BuildParameters(projectCollection);
   var buildRequest = new BuildRequestData(project.CreateProjectInstance(), new[] { "Build" });
   var buildResult = BuildManager.DefaultBuildManager.Build(buildParams, buildRequest);
   
   // 检查构建结果
   if (buildResult.OverallResult == BuildResultCode.Success)
   {
       Console.WriteLine("构建成功！");
   }
   else
   {
       Console.WriteLine("构建失败，错误信息：");
       foreach (var error in buildResult.Errors)
       {
           Console.WriteLine($"- {error.Message}");
       }
   }
   

二、解决System.TypeLoadException异常 #

你碰到的这个异常，核心问题是MSBuild组件版本不匹配：代码试图加载14.0.0.0版本Microsoft.Build.Framework里的IProjectElement，但这个类型在.NET Core兼容的MSBuild版本（15.x及以上）中已经有了结构调整，或是你的项目依赖包版本不一致导致的冲突。

具体修复方案： #

1. 统一所有MSBuild相关NuGet包的版本
   打开你的测试项目文件（.csproj），确保所有Microsoft.Build.*开头的包引用版本完全同步。比如：

   <ItemGroup>
     <PackageReference Include="Microsoft.Build" Version="17.8.3" />
     <PackageReference Include="Microsoft.Build.Framework" Version="17.8.3" />
     <PackageReference Include="Microsoft.Build.CPP.Tasks" Version="17.8.3" />
   </ItemGroup>
   

   版本不一致是这类异常的头号诱因，一定要保证同步。

2. 移除对旧版MSBuild程序集的手动引用
   不要直接引用GAC中的Microsoft.Build.Framework, Version=14.0.0.0，全部依赖NuGet包提供的程序集。如果项目里有<Reference>节点指向旧版本，直接删除即可。

3. 针对C++项目的额外配置
   构建.vcxproj时，需要确保你的.NET Core项目设置了正确的运行时标识符（RID）——因为C++构建工具是平台特定的。在.csproj中添加：

   <PropertyGroup>
     <RuntimeIdentifier>win-x64</RuntimeIdentifier>
     <!-- 也可以选win-x86，根据你的目标平台调整 -->
   </PropertyGroup>
   

   同时，确保你的开发环境安装了对应版本的Visual Studio C++构建工具（比如VS 2022对应MSBuild 17.x）。

4. 清理并重建测试项目
   缓存的旧程序集可能会残留问题，执行以下命令彻底清理：

   dotnet clean
   dotnet restore
   dotnet build
   

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