如何防止matplotlib弹出窗口？在pytest会话中强制非交互模式

当然可以，有几种简单有效的方法能解决本地测试时Matplotlib弹出窗口导致停滞的问题：

1. 全局会话级配置（推荐） #

在项目根目录的conftest.py中添加一个自动执行的fixture，整个pytest会话启动时就把Matplotlib切换到非交互后端：

import pytest
import matplotlib

@pytest.fixture(scope="session", autouse=True)
def set_matplotlib_non_interactive():
    # 强制使用无窗口的Agg后端
    matplotlib.use('Agg', force=True)
    # 关闭交互模式
    matplotlib.rcParams['interactive'] = False

这个fixture会自动作用于所有测试，不需要在每个测试文件中重复配置，彻底避免弹出窗口。

2. 单个测试文件局部配置 #

如果只需要在特定测试文件中生效，直接在文件开头添加以下代码：

import matplotlib

# 切换到非交互后端
matplotlib.use('Agg', force=True)
# 确保pyplot也使用该后端
matplotlib.pyplot.switch_backend('Agg')

force=True参数能强制覆盖任何之前设置的后端，防止其他代码干扰。

3. 借助pytest-mpl插件（适合图形测试场景） #

如果你的测试需要检查Matplotlib图形的细节（比如颜色、数值），pytest-mpl插件不仅能帮你做图形对比测试，还会自动禁用Matplotlib的交互窗口。安装后无需额外配置，插件会默认处理非交互模式。

额外注意点 #

• 检查测试代码中是否有plt.show()调用：即使设置了非交互后端，plt.show()仍可能尝试弹出窗口。可以通过环境变量或pytest参数判断是否跳过该调用：

import os
import matplotlib.pyplot as plt

# 仅在非测试环境显示窗口
if os.getenv('RUNNING_TESTS') != '1':
    plt.show()

或者在运行测试时传递参数：

pytest --run-tests

然后在代码中判断：

import pytest

if not pytest.config.getoption("--run-tests"):
    plt.show()

内容的提问来源于stack exchange，提问作者Pierrick Rambaud