通过C#的Process.Start调用MSBuild失败，但手动执行正常

问题原因 #

从.NET Core/.NET 5+进程启动Visual Studio自带的.NET Framework版MSBuild时，子进程会继承父进程的.NET Core相关环境变量（如DOTNET_ROOT、MSBuildSDKsPath），导致MSBuild错误地尝试加载.NET Core版本的Microsoft.Build.NuGetSdkResolver.dll，而该dll与.NET Framework版MSBuild不兼容，从而抛出格式错误。手动在命令行执行时，环境变量没有这些.NET Core上下文，因此可以正常运行。

解决方案 #

方法1：清除干扰性环境变量 #

在启动MSBuild前，移除ProcessStartInfo中的.NET Core相关环境变量，避免子进程继承：

var processStartInfo = new ProcessStartInfo
{
    FileName = Path.Combine(MSBuildDirectory, "MSBuild.exe"),
    WorkingDirectory = Path.GetDirectoryName(projectToBuild),
    RedirectStandardError = true,
    RedirectStandardInput = true,
    RedirectStandardOutput = true,
    Arguments = $"\"{Path.GetFileName(projectToBuild)}\" /restore -t:build /p:Configuration=Release",
    UseShellExecute = false // 必须设置为false才能修改环境变量
};

// 移除会导致MSBuild加载错误SDK的环境变量
processStartInfo.Environment.Remove("DOTNET_ROOT");
processStartInfo.Environment.Remove("MSBuildSDKsPath");
processStartInfo.Environment.Remove("DOTNET_MULTILEVEL_LOOKUP");

// 可选：重置PATH，优先使用系统和用户级路径，避免父进程的.NET Core路径干扰
var machinePath = Environment.GetEnvironmentVariable("PATH", EnvironmentVariableTarget.Machine);
var userPath = Environment.GetEnvironmentVariable("PATH", EnvironmentVariableTarget.User);
processStartInfo.Environment["PATH"] = $"{machinePath};{userPath}";

var process = Process.Start(processStartInfo);

方法2：通过CMD启动MSBuild #

使用cmd.exe /c启动MSBuild，这样会在全新的shell环境中执行，完全隔离父进程的.NET Core上下文：

var msbuildCommand = $"\"{Path.Combine(MSBuildDirectory, "MSBuild.exe")}\" \"{projectToBuild}\" /restore -t:build /p:Configuration=Release";
var processStartInfo = new ProcessStartInfo
{
    FileName = "cmd.exe",
    WorkingDirectory = Path.GetDirectoryName(projectToBuild),
    RedirectStandardError = true,
    RedirectStandardInput = true,
    RedirectStandardOutput = true,
    Arguments = $"/c {msbuildCommand}",
    UseShellExecute = false
};

var process = Process.Start(processStartInfo);

方法3：指定MSBuild使用的SDK路径 #

如果需要保留部分环境变量，可以显式指定MSBuild使用Visual Studio自带的SDK路径，避免加载.NET Core SDK：

在MSBuild的Arguments中添加/p:MSBuildSDKsPath参数（路径根据你的VS版本和安装位置调整）：

Arguments = $"\"{Path.GetFileName(projectToBuild)}\" /restore -t:build /p:Configuration=Release /p:MSBuildSDKsPath=\"{Path.Combine(MSBuildDirectory, "Sdk")}\"",

验证要点 #

• 确认使用的是Visual Studio安装目录下的MSBuild（如C:\Program Files\Microsoft Visual Studio\2022\Professional\MSBuild\Current\Bin\MSBuild.exe），而非.NET Core SDK中的MSBuild.dll或dotnet msbuild。
• 确保UseShellExecute设置为false，否则无法修改环境变量，子进程会继承父进程的所有环境。

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