使用MSBuild及MSBuild API构建项目失败：无法加载Message任务

我之前也碰到过一模一样的问题，给你几个亲测有效的解决思路：

1. 对齐MSBuild NuGet包与本地版本 #

你使用的是VS2017自带的MSBuild 15.0，必须保证项目引用的MSBuild相关NuGet包（比如Microsoft.Build、Microsoft.Build.Tasks.Core）版本和本地MSBuild的版本完全匹配。

• 右键项目 → 管理NuGet包，搜索这些包，将版本切换为15.x系列（比如15.1.0.0对应的NuGet版本），避免安装过高（如16+）或过低的版本。

2. 手动指定MSBuild加载路径 #

使用MSBuild API时，程序集可能会从非预期路径加载，你可以在代码里手动指定本地VS2017的MSBuild路径，确保加载正确的程序集：

string msbuildInstallPath = @"D:\Visual Studio\2017\MSBuild\15.0\Bin";
Environment.SetEnvironmentVariable("MSBUILD_EXE_PATH", Path.Combine(msbuildInstallPath, "MSBuild.exe"));
// 之后再初始化MSBuild引擎进行构建

3. 修复VS/MSBuild安装组件 #

如果上述方法无效，大概率是VS2017的MSBuild组件损坏：

• 打开Visual Studio Installer，选择你的VS2017实例点击「修改」，确认「MSBuild工具」相关组件已勾选，然后重新安装修复。
• 也可以直接下载对应版本的MSBuild独立安装包进行修复。

4. 检查程序集及其依赖项 #

错误提示提到“无法加载文件或程序集或其依赖项之一”，可以做以下检查：

• 打开路径D:\Visual Studio\2017\MSBuild\15.0\Bin，确认Microsoft.Build.Tasks.Core.dll是否存在；
• 使用Dependency Walker这类工具，检查该dll的依赖项是否有缺失。

原错误信息 #

D:\Visual Studio\2017\MSBuild\15.0\Bin\Microsoft.Common.CurrentVersion.targets(753,5) (MSBuild):无法从程序集Microsoft.Build.Tasks.Core, Version=15.1.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a加载“Microsoft.Build.Tasks.Message”任务。无法加载文件或程序集'Microsoft.Build.Tasks.Core, Version=15.1.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a'或其依赖项之一...

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