pytest实时输出日志配置详解

pytest默认会捕获并丢弃测试中的print()输出和logging日志，导致调试时控制台“静默无声”，根本原因在于输出被拦截而非代码未执行；要实现实时可见，需明确区分处理：用`-s`参数释放print()等标准输出，用`--log-cli-level=LEVEL`（如INFO或DEBUG）配合代码中logger.setLevel()显式设置日志级别来激活日志输出，二者缺一不可；配置文件中也须在`[tool.pytest.ini_options]`下正确声明`log_cli = true`和`log_cli_level = "INFO"`（字符串带引号），避免常见失效陷阱——掌握这一组合逻辑，就能让调试信息即时、清晰地呈现在终端，大幅提升测试开发效率。

pytest 运行时看不到 print() 或 logging 输出？先确认 log_cli 是否启用

默认情况下，pytest 会捕获所有 stdout/stderr 和 logging 输出，测试通过就直接丢弃——所以你加了 print("debug") 或 logging.info("start")，控制台完全没反应。根本原因不是代码没执行，而是输出被 pytest 拦截了。log_cli 是开关，但它本身不生效，必须配合 log_level 才能真正显示日志。

启用实时日志输出：命令行加 --log-cli-level=INFO 最快

不用改配置文件，临时调试时直接加参数就行。注意两点：一是必须用 --log-cli-level（不是 --log-level），二是等级要设够高（比如 INFO 或 DEBUG），否则 logging.debug() 仍不会出现。

• pytest --log-cli-level=INFO test_example.py → 显示 INFO 及以上日志
• pytest --log-cli-level=DEBUG -s test_example.py → 加 -s 才放行 print()，DEBUG 级日志也可见
• 如果只加 --log-cli 不带 =LEVEL，pytest 会按默认 WARNING 级处理，INFO 日志照样沉默

pyproject.toml 里配 log_cli 和 log_level 要写对位置

很多人在 [tool.pytest.ini_options] 下只写 log_cli = true，结果还是没日志——因为缺少 log_level，或者写错层级。正确写法：

[tool.pytest.ini_options]
log_cli = true
log_cli_level = "INFO"
log_cli_format = "%(asctime)s [%(levelname)8s] %(name)s: %(message)s"
log_cli_date_format = "%Y-%m-%d %H:%M:%S"

关键点：log_cli_level 必须显式声明（不能依赖全局 log_level），且值是字符串（带引号）；log_cli_format 和 log_cli_date_format 是可选但实用的美化项。

print() 和 logging 输出行为不同，别混用同一套逻辑

print() 属于 stdout，受 -s 控制；logging 属于日志系统，受 --log-cli-level 控制。两者互不影响：

• 只加 --log-cli-level=INFO → logging.info() 可见，print() 仍被吞
• 只加 -s → print() 可见，logging.info() 仍不可见（除非同时配日志级别）
• 想全看到？命令行组合用：pytest -s --log-cli-level=DEBUG
• 注意：logging.getLogger(__name__) 创建的 logger 默认 level 是 WARNING，即使 pytest 设了 DEBUG，也要在代码里调 logger.setLevel(logging.DEBUG) 或用 basicConfig

最常被忽略的是 logger 自身的 level 设置——pytest 只负责把日志“放行”，不负责把 logger 的门打开。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《pytest实时输出日志配置详解》文章吧，也可关注golang学习网公众号了解相关技术文章。