.NET XUnit测试中AddConsole()无法输出日志至控制台的原因咨询

xUnit的测试执行环境做了隔离处理：

• 测试进程的标准输出（Console）会被xUnit测试运行器捕获并默认隐藏，不会直接转发到你执行dotnet test的终端控制台。
• builder.AddConsole()是将日志写入系统标准输出，但这个输出被xUnit拦截了，所以你在dotnet test的输出里看不到这些日志。
• 而ITestOutputHelper是xUnit官方提供的测试输出通道，它的输出会被测试运行器收集，当你指定--logger "console;verbosity=detailed"时，才会把这些收集到的内容打印到终端。

不用手动实现完整的ILoggerProvider，可以通过以下方式简化：

方式1：简化自定义Logger实现 #

using Microsoft.Extensions.Logging;
using Xunit.Abstractions;

public static class XunitLoggerExtensions
{
    public static ILoggingBuilder AddXunit(this ILoggingBuilder builder, ITestOutputHelper outputHelper)
    {
        builder.AddProvider(new XunitLoggerProvider(outputHelper));
        return builder;
    }

    private class XunitLoggerProvider : ILoggerProvider
    {
        private readonly ITestOutputHelper _output;

        public XunitLoggerProvider(ITestOutputHelper output) => _output = output;

        public ILogger CreateLogger(string categoryName) => new XunitLogger(_output, categoryName);

        public void Dispose() { }
    }

    private class XunitLogger : ILogger
    {
        private readonly ITestOutputHelper _output;
        private readonly string _categoryName;

        public XunitLogger(ITestOutputHelper output, string categoryName)
        {
            _output = output;
            _categoryName = categoryName;
        }

        public IDisposable BeginScope<TState>(TState state) => null;

        public bool IsEnabled(LogLevel logLevel) => true;

        public void Log<TState>(LogLevel logLevel, EventId eventId, TState state, Exception exception, Func<TState, Exception, string> formatter)
        {
            var message = $"[{logLevel}] {_categoryName}: {formatter(state, exception)}";
            _output.WriteLine(message);
        }
    }
}

测试类中直接调用扩展方法：

using Microsoft.Extensions.Logging;
using Xunit;
using Xunit.Abstractions;

public class UnitTest3
{
    private readonly ILogger<UnitTest3> _logger;

    public UnitTest3(ITestOutputHelper outputHelper)
    {
        var loggerFactory = LoggerFactory.Create(builder =>
        {
            builder.AddXunit(outputHelper);
            builder.SetMinimumLevel(LogLevel.Debug);
        });
        _logger = loggerFactory.CreateLogger<UnitTest3>();
    }

    [Fact]
    public void MyTest_Method_Should_Log_Messages()
    {
        _logger.LogInformation("Information message");
        _logger.LogError(new Exception("Test exception"), "Error occurred");
    }
}

方式2：使用现成NuGet包 #

可以直接安装Xunit.Extensions.Logging这类专用包，安装后无需手写Logger代码，直接在日志构建器中调用AddXunit(outputHelper)即可，实现逻辑和上述简化代码一致。

执行测试时必须指定控制台日志记录器并设置详细级别，才能看到测试输出的日志：

dotnet test --logger "console;verbosity=detailed"

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