使用MSBuild.CodeAnalysis API分析C#项目时遭遇文件未找到错误

问题原因 #

MSBuildLocator.RegisterDefaults() 默认优先选择.NET SDK目录中的MSBuild，但该版本的MSBuild可能缺少部分资源文件（如Microsoft.Build.resources.dll）；而Visual Studio自带的MSBuild组件是完整的，包含所有必要的依赖文件。

解决方案 #

1. 优先注册Visual Studio自带的MSBuild实例 #

修改Main方法中的注册逻辑，放弃默认注册，改为选择Query到的Visual Studio实例（优先最新版本）：

public static async Task Main(string[] args)
{
    // 查询所有Visual Studio实例并按版本倒序排列
    var vsInstances = MSBuildLocator.QueryVisualStudioInstances()
        .OrderByDescending(instance => instance.Version)
        .ToList();

    if (vsInstances.Any())
    {
        // 注册最新的VS实例中的MSBuild
        MSBuildLocator.RegisterInstance(vsInstances.First());
    }
    else
    {
        // 无VS实例时回退到默认注册
        MSBuildLocator.RegisterDefaults();
    }

    await DoActualWork();
}

2. 确认Visual Studio组件完整性 #

确保你的Visual Studio 2022安装了**.NET桌面开发**工作负载，该负载包含完整的MSBuild运行时及依赖文件。若未安装，可通过VS安装程序补充安装。

3. 语言文化兼容性调整（可选） #

若系统语言与.NET SDK默认语言不匹配，可能导致资源dll加载失败。可尝试安装对应语言的.NET 7 SDK语言包，或在代码启动时设置线程文化：

// 在Main方法最顶部添加
System.Threading.Thread.CurrentThread.CurrentUICulture = new System.Globalization.CultureInfo("en-US");

额外检查 #

• 确认待分析项目的路径正确，且程序有访问该路径的权限
• 当前使用的Microsoft.Build.Locator 1.5.5与Microsoft.CodeAnalysis.Workspaces.MSBuild 4.4.0版本兼容，无需调整包版本

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