Python调试日志：pytest捕获标准输出

理解 pytest 的标准输出捕获机制

pytest 默认会拦截并捕获测试函数中通过 print() 或 sys.stdout.write() 产生的标准输出（stdout）。这一设计的核心目的是保持终端界面的整洁，避免大量调试信息淹没关键的测试报告与统计摘要。只有当测试用例执行失败、抛出异常或显式要求时，pytest 才会将捕获到的 stdout 内容附加在错误回溯信息之后一并展示。需要明确的是，stdout 与 stderr 在 pytest 中是独立捕获的：stdout 通常用于常规程序输出，而 stderr 专门用于错误流、警告信息及部分底层库的日志。pytest 的捕获机制在测试函数开始执行时自动开启，在函数退出时释放。理解这一机制有助于开发者在编写测试时合理选择输出方式，避免在调试时因看不到打印而产生困惑。

查看和控制测试中的标准输出

若需在测试运行期间实时查看标准输出，可通过命令行参数 -s（等价于 --capture=no）直接关闭 pytest 的捕获功能，此时 print() 的内容会立即打印到终端，便于交互式调试。对于需要保留捕获机制但又要验证输出内容的场景，pytest 提供了内置的 capsys 夹具。在测试函数中声明 capsys 参数后，pytest 会自动接管标准流。调用 capsys.readouterr() 即可获取当前已捕获的 out（stdout）和 err（stderr）字符串。例如，执行完目标函数后，可通过 captured = capsys.readouterr() 获取输出，并使用 assert "expected text" in captured.out 进行精确断言。这种方式既不影响测试报告的整洁性，又能实现自动化验证，是编写高质量集成测试的标准实践。

运行测试验证捕获结果

为验证捕获机制的实际表现，可编写一个最小化测试文件 test_stdout_demo.py。其中包含三个用例：第一个仅调用 print("pass_msg") 并断言成功，默认运行时终端不会显示该打印内容；第二个同样打印 print("fail_msg") 但故意触发 assert False，运行后终端会在失败报告中完整展示被捕获的 stdout；第三个使用 capsys 夹具，执行 print("verify_msg") 后调用 out = capsys.readouterr().out 并断言 out == "verify_msg\n"。通过执行 pytest test_stdout_demo.py 可观察默认行为，添加 -s 可对比实时输出差异，而使用 pytest test_stdout_demo.py::test_with_capsys 则能验证断言逻辑。这种对照测试能直观确认捕获配置是否按预期生效，并帮助开发者掌握不同参数下的输出流向。

常见误区与调试避坑

开发者在使用 pytest 时极易陷入几个典型误区。首先是 print() 看不到输出，这并非代码未执行，而是 pytest 默认捕获所致，应使用 -s 参数临时放行或借助 capsys 读取。其次是将 -s 与捕获机制混淆，误以为 -s 是开启捕获，实则它是关闭捕获的开关，日常调试可临时使用，但持续集成中建议保留默认捕获以维持日志清晰。第三是只在失败时寻找输出，若需验证正常流程的打印内容，必须依赖 capsys 或 caplog 进行主动读取与断言。最后是 stdout 与 logging 混用问题：print 走标准输出流，而 logging 默认输出到 stderr 或独立处理器，pytest 对两者的捕获策略不同。调试时应统一输出通道，或使用 caplog 专门验证日志级别与内容，避免流混淆导致断言失效或调试信息遗漏。