如何从xUnit测试向Azure DevOps任务日志写入内容？

我明白你遇到的问题——本地运行xUnit测试时用Console.WriteLine()这类方法能看到输出，但到了Azure DevOps构建代理上就没影了。这是因为xUnit默认会重定向控制台、Debug和Trace的输出，不会直接推送到构建任务的日志流里。下面是几种可靠的解决方案：

1. 使用xUnit官方推荐的ITestOutputHelper（最稳妥） #

这是xUnit专门用来捕获测试输出的工具，Azure DevOps会自动把这些输出纳入任务日志和测试报告中。用法很简单：

• 在测试类的构造函数中注入ITestOutputHelper
• 用它的WriteLine()方法输出内容

示例代码：

using Xunit;
using Xunit.Abstractions;

public class MyTestClass
{
    private readonly ITestOutputHelper _testOutput;

    // 通过构造函数注入输出助手
    public MyTestClass(ITestOutputHelper testOutput)
    {
        _testOutput = testOutput;
    }

    [Fact]
    public void MyTestMethod()
    {
        // 输出普通信息
        _testOutput.WriteLine("当前测试开始执行，参数：{0}", "test-value");
        
        try
        {
            // 你的测试逻辑
            var result = 1 + 1;
            _testOutput.WriteLine("计算结果：{0}", result);
        }
        catch (Exception ex)
        {
            // 输出异常详情，方便排查问题
            _testOutput.WriteLine("测试出现异常：{0}", ex.ToString());
            throw; // 不要吞掉异常，否则测试会被标记为通过
        }
    }
}

2. 调整dotnet test的日志级别 #

在Azure DevOps的测试任务（比如DotNetCoreCLI任务）中，确保运行测试的命令包含足够详细的日志级别参数，这样xUnit的输出才会被完整捕获。比如：

dotnet test --verbosity detailed

或者用normal级别，也能显示测试的输出内容。在Azure DevOps任务配置里，把命令参数设置成这个即可。

3. 用日志框架输出到控制台（可选） #

如果你已经在用Serilog、NLog之类的日志框架，可以配置它们将日志输出到控制台，同时确保xUnit不拦截控制台输出。不过需要额外配置：

比如用Serilog的话，可以在测试项目中配置：

Log.Logger = new LoggerConfiguration()
    .WriteTo.Console()
    .CreateLogger();

然后在测试中用Log.Information()输出，同时在dotnet test命令中加上--verbosity detailed，这样Azure DevOps会捕获控制台的日志。

为什么Console.WriteLine()等方法无效？ #

xUnit的设计是将Console、Debug和Trace的输出重定向到ITestOutputHelper，所以直接调用这些方法的输出不会直接进入构建代理的控制台流，只有通过ITestOutputHelper输出的内容才会被xUnit收集，进而被Azure DevOps的任务日志捕获。

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