Visual Studio输出窗口无法显示自定义MSBuild Logger日志的问询

核心问题分析 #

Visual Studio集成的MSBuild会拦截并过滤Logger输出，默认仅允许匹配当前日志级别（Minimal）的消息通过；同时直接用Console/Trace等方式写入的内容，VS输出窗口不会捕获，必须通过MSBuild官方日志通道，并正确处理日志级别与VS转发机制。

具体解决步骤 #

1. 强制指定日志级别绕过过滤 #

MSBuild的Minimal级别对应MessageImportance.Normal及以上优先级，要让低优先级日志显示，需在发送时将其标记为Normal或更高级别，避免被VS过滤规则拦截。

示例代码片段：

public override void Initialize(IEventSource eventSource)
{
    // 订阅所有消息事件
    eventSource.MessageRaised += OnMessageRaised;
}

private void OnMessageRaised(object sender, BuildMessageEventArgs e)
{
    // 匹配需要显示的低优先级日志，强制设置级别为Normal
    if (e.Message.Contains("目标日志关键词"))
    {
        // 使用TaskLoggingHelper发送指定级别的日志
        Log.LogMessage(MessageImportance.Normal, e.Message);
    }
}

2. 用VS兼容的日志通道输出 #

VS内部的MSBuild依赖VisualStudioLogger处理输出，自定义Logger需通过官方API发送消息，而非直接写Console/Trace：

• 优先使用任务类自带的Log属性（TaskLoggingHelper实例），它会自动适配VS的日志转发通道；
• 若在独立Logger中，需确保调用BuildEngine.LogMessageEvent时传入带正确Importance的BuildMessageEventArgs。

注意：不要在事件处理方法中新建TaskLoggingHelper，要复用任务初始化时的实例。

3. 确保Logger注册时机正确 #

避免在任务Execute方法中临时注册Logger，建议通过项目文件配置关联到整个构建流程：

<UsingTask TaskName="YourCustomTask" AssemblyFile="YourTaskAssembly.dll" />
<Target Name="BeforeBuild">
  <YourCustomTask>
    <Output TaskParameter="CustomLogger" ItemName="RegisteredLoggers" />
  </YourCustomTask>
</Target>

或在VS启动构建时通过MSBuild参数/logger注册Logger，确保其在构建全程生效。

4. 验证VS日志级别配置 #

打开VS的工具 -> 选项 -> 项目和解决方案 -> 生成并运行，确认“MSBuild项目生成输出详细程度”设为Minimal，同时保证自定义Logger发送的日志级别为Normal或更高，避免被VS过滤。

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