无需命令行，通过MSBuild编程构建VS2015多C#项目及日志输出咨询

结论先行：必须用MSBuild API #

没错，要实现无命令行、编程式逐个构建项目、输出日志到文件的需求，MSBuild API是最佳选择——它直接提供了与Visual Studio构建引擎交互的原生接口，完全匹配你的场景，不用绕命令行的弯路。

第一步：添加MSBuild API引用 #

针对VS2015项目，有两种靠谱的引用方式：

• 方式1：NuGet安装（推荐）
  在NuGet包管理器中搜索并安装Microsoft.Build、Microsoft.Build.Framework、Microsoft.Build.Engine这三个包，选择对应VS2015的14.0.x版本，版本匹配更省心。
• 方式2：直接引用GAC程序集
  右键项目→添加引用→浏览到C:\Program Files (x86)\MSBuild\14.0\Bin目录，选择上述三个程序集（注意和你的项目平台x86/x64保持一致）。

第二步：核心实现代码 #

下面是完整的可复用代码，包含自定义文件日志记录器和逐个构建项目的逻辑：

1. 自定义文件日志类 #

这个类实现ILogger接口，专门负责把构建日志写入指定文件：

using Microsoft.Build.Framework;
using System.IO;

public class FileBuildLogger : ILogger
{
    private StreamWriter _logWriter;
    public LoggerVerbosity Verbosity { get; set; }
    public string Parameters { get; set; }

    public void Initialize(IEventSource eventSource)
    {
        if (!string.IsNullOrEmpty(Parameters))
        {
            _logWriter = new StreamWriter(Parameters, append: true);
            _logWriter.WriteLine($"=== 构建开始：{DateTime.Now:yyyy-MM-dd HH:mm:ss} ===");
        }

        // 订阅所有构建事件
        eventSource.ErrorRaised += EventSource_ErrorRaised;
        eventSource.WarningRaised += EventSource_WarningRaised;
        eventSource.MessageRaised += EventSource_MessageRaised;
        eventSource.BuildFinished += EventSource_BuildFinished;
    }

    private void EventSource_BuildFinished(object sender, BuildFinishedEventArgs e)
    {
        _logWriter.WriteLine($"=== 构建结束：{DateTime.Now:yyyy-MM-dd HH:mm:ss} 结果：{(e.Succeeded ? "成功" : "失败")} ===");
        _logWriter.WriteLine();
        _logWriter.Close();
    }

    private void EventSource_MessageRaised(object sender, BuildMessageEventArgs e)
    {
        if (e.Importance == MessageImportance.High || Verbosity >= LoggerVerbosity.Detailed)
        {
            _logWriter.WriteLine($"[消息] {e.Message}");
        }
    }

    private void EventSource_WarningRaised(object sender, BuildWarningEventArgs e)
    {
        _logWriter.WriteLine($"[警告] {e.File}({e.LineNumber},{e.ColumnNumber}): {e.Message}");
    }

    private void EventSource_ErrorRaised(object sender, BuildErrorEventArgs e)
    {
        _logWriter.WriteLine($"[错误] {e.File}({e.LineNumber},{e.ColumnNumber}): {e.Message}");
    }

    public void Shutdown()
    {
        _logWriter?.Close();
    }
}

2. 构建项目的核心方法 #

这个方法会按你指定的顺序逐个加载并构建项目，同时用上面的日志记录器输出结果：

using Microsoft.Build.Evaluation;
using Microsoft.Build.Execution;

public bool BuildProjects(List<string> projectPaths, string logFilePath, string configuration = "Debug", string platform = "Any CPU")
{
    bool allSucceeded = true;

    // 初始化MSBuild项目集合
    using (var projectCollection = new ProjectCollection())
    {
        // 设置构建属性（配置、平台）
        var globalProperties = new Dictionary<string, string>
        {
            { "Configuration", configuration },
            { "Platform", platform }
        };

        // 创建并注册自定义日志器
        var logger = new FileBuildLogger
        {
            Verbosity = LoggerVerbosity.Detailed,
            Parameters = logFilePath
        };
        projectCollection.RegisterLogger(logger);

        foreach (var projectPath in projectPaths)
        {
            try
            {
                // 加载VS2015项目（指定14.0版本）
                var project = projectCollection.LoadProject(projectPath, globalProperties, "14.0");
                
                // 执行构建
                var buildResult = project.Build();

                if (!buildResult)
                {
                    allSucceeded = false;
                    // 可在这里添加单个项目构建失败的额外处理逻辑
                }
            }
            catch (Exception ex)
            {
                allSucceeded = false;
                // 捕获异常并写入日志
                using (var writer = new StreamWriter(logFilePath, append: true))
                {
                    writer.WriteLine($"[异常] 处理项目 {projectPath} 时出错：{ex.Message}");
                }
            }
        }

        // 注销日志器
        projectCollection.UnregisterAllLoggers();
    }

    return allSucceeded;
}

第三步：使用示例 #

在你的Windows应用中，直接调用上述方法即可：

// 按依赖顺序定义要构建的项目路径
var projectsToBuild = new List<string>
{
    @"C:\YourSolution\CoreLibrary\CoreLibrary.csproj",
    @"C:\YourSolution\MainApp\MainApp.csproj"
};

// 指定日志文件路径
var logPath = @"C:\BuildLogs\BuildResult.log";

// 执行构建（这里用Release+x64配置）
bool buildSuccess = BuildProjects(projectsToBuild, logPath, "Release", "x64");

// 根据结果做后续处理
if (buildSuccess)
{
    MessageBox.Show("所有项目构建成功！");
}
else
{
    MessageBox.Show("部分或全部项目构建失败，请查看日志文件。");
}

关键注意事项 #

• 项目顺序：如果项目之间有依赖关系，一定要按依赖顺序排列（先构建基础类库，再构建依赖它的应用），否则会构建失败。
• 版本匹配：VS2015对应MSBuild 14.0，加载项目时必须指定版本号"14.0"，避免版本不兼容问题。
• 权限问题：确保你的应用有足够权限写入日志目录，以及访问项目文件和输出目录。
• 日志覆盖：如果需要每次构建覆盖旧日志，把FileBuildLogger中的append: true改成false即可。

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