.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。
总结
微软系列的东西最好是全部向最新版看齐。