C#类库项目中NUnit(.NET Core)测试执行时如何实时查看控制台输出

默认在类库类的NUnit测试项目中，Console.WriteLine()、常规TestContext.WriteLine()输出的内容会被测试宿主做统一缓冲收集，等全部测试执行完成后才推送到测试资源管理器的输出面板，面对长耗时测试用例时必须等全部跑完才能看日志，没法在测试运行过程中实时获取输出内容，可通过以下方式实现实时日志查看：

• 开启Visual Studio内置的实时日志流功能
  操作路径：打开VS「工具」→「选项」→「测试」配置页，勾选「启用实时日志流」选项，将对应日志传输级别调整为需要的输出层级（如Trace、Information）。配置生效后，测试运行过程中产生的所有控制台、测试上下文输出会被实时推送到测试输出窗口，无需等待整个测试任务执行完成。
• 使用NUnit原生的实时进度日志接口替代常规日志写入
  NUnit中提供的TestContext.Progress.WriteLine()是专门设计的实时进度输出接口，和会被缓冲收集的常规日志不同，它的输出会直接跳过NUnit自身的日志缓存层，直接推送到测试宿主的输出通道。只要配合VS的实时日志流开关打开，就能做到写一行立刻显示一行，没有缓冲延迟。
• 重定向日志输出到本地物理文件绕过宿主缓冲
  如果开启实时流后仍有输出延迟，可在测试项目初始化阶段将所有日志输出重定向到本地实时刷新的文件流，通过编辑器的文件实时同步功能查看日志。核心实现参考：

  // 测试程序集初始化阶段执行一次性配置
  [AssemblyInitialize]
  public static void InitGlobalLogStream(TestContext context)
  {
      // 生成带时间戳的本地日志文件
      var logFilePath = Path.Combine(
          TestContext.CurrentContext.TestDirectory, 
          $"test-runtime-log-{DateTime.Now:yyyyMMdd-HHmmss}.log");
      // 设置文件访问权限，保证写入的同时可被其他程序读取
      var fileStream = new FileStream(
          logFilePath, 
          FileMode.Create, 
          FileAccess.Write, 
          FileShare.ReadWrite);
      var logWriter = new StreamWriter(fileStream) { AutoFlush = true };
      // 重定向控制台输出到实时刷新的文件流
      Console.SetOut(logWriter);
      // 同步将TestContext的实时进度输出写入文件
      TestContext.Progress.WriteLine($"实时日志文件已创建：{logFilePath}");
  }
  

  配置完成后，所有通过Console.WriteLine()、TestContext.Progress.WriteLine()写入的内容都会因为AutoFlush=true设置实时写入文件，用VSCode、记事本等支持文件实时刷新的编辑器打开对应日志文件，就能看到滚动更新的运行日志，完全不受测试执行进度的限制。

注意：配置文件日志输出时，不要关闭StreamWriter的AutoFlush开关，否则内容会在内存缓冲区攒到一定大小才写入文件，失去实时查看的效果。

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