如何通过conftest.py程序化禁用pytest的terminalreporter插件？

要实现通过conftest.py程序化禁用terminal插件（等效于命令行-p no:terminal），并替换成自定义的报告功能，可以利用pytest的钩子函数完成，以下是具体方案：

一、程序化禁用terminal插件 #

使用pytest_load_initial_conftests钩子，在pytest加载插件的早期阶段动态添加禁用选项：

def pytest_load_initial_conftests(early_config, parser, args):
    # 避免重复添加禁用选项
    if "-p" in args and "no:terminal" in args:
        return
    # 添加禁用terminal插件的参数
    args.extend(["-p", "no:terminal"])

这个钩子会在pytest加载初始配置和插件之前触发，修改命令行参数后，pytest就不会加载原生的terminal插件，效果和在pytest.ini的addopts里配置完全一致。

二、完全替代terminalreporter功能 #

如果要彻底替换原生的terminalreporter，你可以注册自己的自定义报告类，并注销原生的terminal插件：

import pytest

class CustomTerminalReporter:
    def __init__(self, config):
        self.config = config
        # 用于收集不同结果类型的测试用例
        self.test_stats = {"passed": [], "failed": [], "skipped": []}

    def pytest_sessionstart(self, session):
        print("=== 自定义测试会话启动 ===")

    def pytest_runtest_logreport(self, report):
        # 收集每个测试用例的结果
        if report.when == "call":
            self.test_stats[report.outcome].append(report.nodeid)

    def pytest_sessionfinish(self, session):
        # 输出自定义格式的测试汇总
        print("\n=== 自定义测试结果汇总 ===")
        for result_type, cases in self.test_stats.items():
            print(f"{result_type.upper()}: {len(cases)} 个用例")
            if cases:
                print(f"  具体用例: {', '.join(cases)}")

def pytest_configure(config):
    # 实例化自定义reporter
    custom_reporter = CustomTerminalReporter(config)
    # 获取原生terminal插件并注销
    terminal_plugin = config.pluginmanager.getplugin("terminal")
    if terminal_plugin:
        config.pluginmanager.unregister(terminal_plugin)
    # 注册自定义reporter，替换原生插件
    config.pluginmanager.register(custom_reporter, "terminal")

关键说明： #

• pytest_configure钩子在pytest配置阶段执行，这里我们先移除原生的terminal插件，再注册自己的实现，确保pytest使用自定义的报告逻辑。
• 自定义报告类需要实现pytest的相关钩子函数，比如pytest_sessionstart（会话启动时执行）、pytest_runtest_logreport（处理单个测试报告）、pytest_sessionfinish（会话结束时输出汇总），你可以根据需求扩展更多钩子。

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