【BUG】.NET项目｜未能加载文件或程序集“xxx”，或它的某一个依赖项。系统找不到指定的文件的通解

出错代码：

MSBuildWorkspace workspace = CreateWorkspace();
Solution solution = workspace.OpenSolutionAsync(solutionPath).Result;

在OpenSolutionAsync(solutionPath).Result获取Result的时候一直报错，称未能加载文件或程序集。
但是我系统的.NET、visual studio、nuget等均已经是最高版本。
而且单独打开solutionPath对应的.sln工程文件时都能正常编译生成。

偏偏这行报错。

实际上，这个报错还是因为.NET、MSbuild版本过低。低版本不兼容高版本的库。

文章目录

• • 第一步
  • • 安装NET 6.0
    • 安装最新版Visual Studio
    • 更新nuget
  • 第二步
  • • 更新目标框架
    • 更新项目依赖
  • 第三步
  • 第四步
  • 总结

第一步

你的系统中需要有更高版本的.NET、visual studio、nuget。

安装NET 6.0

注：现在(2022年6月3日)已经有NET 7.0 preview了，但没有stable，也可以装NET 7.0。

点击下载：下载 .NET 6.0 (Linux、macOS 和 Windows)。

安装最新版Visual Studio

注：现在最新版是VS 2022。

点击进入官网的安装教程：安装 Visual Studio。

更新nuget

运行如下指令：

nuget update -self

注：若上述指令提示称未安装nuget，请先安装。
点击进入NuGet下载页：Available NuGet Distribution Versions。

第二步

更新目标框架

先右键项目，选择项目属性，设置Target Framework(目标框架)，改成最新版.NET Framework或者最新版.NET Core的框架（就是你当前使用的版本）。

更改完成后，重新编译一次，保证当前修改不影响代码编译，并确定代码能够用于新的框架。

更新项目依赖

右键出错的项目，点击管理NuGet程序包。

然后更新所有依赖：

注意：若你的目标框架未修改，更新将不会成功。

更新依赖后，重新运行代码，就不会出现找不到程序集的报错了。

第三步

倘若一切都是最新版，仍然找不到程序集，这说明你的项目缺少对这个程序集的引用，但又确实用到了该程序集。

这种情况，在NuGet中安装该程序集，即可解决问题。

例如报错未能加载文件或程序集System.IO.FileNotFoundException:“未能加载文件或程序集“System.Runtime.CompilerServices.Unsafe, Version=4.0.4.1, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a”或它的某一个依赖项。系统找不到指定的文件。。

注：安装时需确保程序集的依赖项符合当前项目的版本。

第四步

倘若第三步找不到报错提到的程序集、或者已经安装了最新版但仍然提示旧版的报错，可考虑引用顺序，或是否安装错了一个程序集。

这一类的典型：

{"未能从程序集“Microsoft.Build.Framework, Version=15.1.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a”中加载类型“Microsoft.Build.Framework.IMetadataContainer”。":"Microsoft.Build.Framework.IMetadataContainer"}

已知Microsoft.Build.Framework已经安装了17.2.0，可报错提示说15.1.0.0中有东西找不到。
即使将using Microsoft.Build.Framework;这行注释掉，报错提示还是不变
——这是因为，其他的程序集中也有Microsoft.Build.Framework，它们的版本过低，并且比Microsoft.Build.Framework先一步被引用。

可以调整using顺序，也可以安装最新版Microsoft.Build，直接解决这个问题。

注：Microsoft.Build.Framework属于Microsoft.Build，但在NuGet中被作为两个包发布，假设已经安装Microsoft.Build，就不需要再安装Microsoft.Build.Framework。

总结

微软系列的东西最好是全部向最新版看齐。