使用Roslyn加载C#项目时NuGet依赖解析失败的解决方案咨询

一、先确认NuGet包已完整还原 #

• 手动触发还原：在项目根目录执行 dotnet restore 命令，或者在VS里右键解决方案选「还原NuGet包」，保证所有依赖包都下载到本地NuGet缓存（默认路径是%userprofile%\.nuget\packages）。
• 检查.csproj文件：确认所有<PackageReference>节点配置正确，没有版本冲突或拼写错误，示例：

  <PackageReference Include="Newtonsoft.Json" Version="13.0.3" />
  

二、配置Roslyn加载正确的程序集路径 #

方法1：手动指定引用路径 #

用Roslyn加载项目时，明确添加NuGet包路径和项目bin目录的程序集引用：

var workspace = MSBuildWorkspace.Create();
var project = await workspace.OpenProjectAsync("YourProject.csproj");

// 获取项目输出目录
var outputDir = project.GetPropertyValue("OutputPath");
var targetFramework = project.GetPropertyValue("TargetFramework");
var fullOutputPath = Path.Combine(project.DirectoryPath, outputDir, targetFramework);

// 拼接NuGet包的实际路径
var packageReferences = project.Items.Where(i => i.ItemType == "PackageReference");
var nugetAssemblies = packageReferences.SelectMany(p => {
    var packageId = p.EvaluatedInclude;
    var version = p.GetMetadataValue("Version");
    var packageLibPath = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.UserProfile), ".nuget", "packages", packageId, version, "lib", targetFramework);
    return Directory.GetFiles(packageLibPath, "*.dll").Select(dll => MetadataReference.CreateFromFile(dll));
});

// 合并bin目录和NuGet的程序集引用
var existingReferences = await project.GetMetadataReferencesAsync();
var allReferences = existingReferences.Concat(nugetAssemblies)
    .Concat(Directory.GetFiles(fullOutputPath, "*.dll").Select(dll => MetadataReference.CreateFromFile(dll)));

var compilation = await project.GetCompilationAsync(compilationOptions: project.CompilationOptions.WithMetadataReferences(allReferences));

方法2：加载整个解决方案让MSBuild自动处理 #

不要单独加载项目，直接加载解决方案，让MSBuildWorkspace自动复用VS的构建配置：

var workspace = MSBuildWorkspace.Create();
// 监听加载错误方便排查
workspace.WorkspaceFailed += (sender, e) => Console.WriteLine(e.Diagnostic.Message);
var solution = await workspace.OpenSolutionAsync("YourSolution.sln");

// 获取目标项目的编译对象
var targetProject = solution.Projects.First(p => p.Name == "YourProject");
var compilation = await targetProject.GetCompilationAsync();

这种方式会自动识别NuGet依赖路径、输出目录等配置，和VS构建逻辑保持一致。

三、匹配Roslyn与VS的版本 #

确保你引用的Microsoft.CodeAnalysis系列NuGet包版本和当前VS使用的Roslyn版本尽量一致（比如VS2022对应Roslyn 4.x），版本差异可能导致依赖解析逻辑不兼容。

四、强制加载bin目录所有程序集 #

如果以上方法无效，直接遍历bin目录下的所有dll，添加到编译引用：

var binDir = Path.Combine(project.DirectoryPath, "bin", "Debug", "net6.0"); // 替换成你的实际输出目录
var binReferences = Directory.GetFiles(binDir, "*.dll")
    .Select(dllPath => MetadataReference.CreateFromFile(dllPath));

var compilation = await project.GetCompilationAsync();
compilation = compilation.AddReferences(binReferences);

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