pytest-env插件如何设置Python固定测试环境变量？

如何为Python测试配置固定环境变量？

在Python测试中，环境变量管理是常见需求。部分开发者可能考虑使用pytest-env插件，但目前该插件已不再适合继续使用。

pytest-env 插件被淘汰的原因

该插件已三年未更新，最后一次发布是2021年的v0.6.2版本。它既不兼容pytest 8及以上版本，在Python 3.12环境下还会因pkg_resources被弃用而直接报错：ModuleNotFoundError: No module named 'pkg_resources'。此外，它并非pytest官方推荐的方案。目前已有更可靠的原生机制可以替代，无需继续依赖旧工具。

轻量方案：使用 --envfile 加载 .env 文件

从pytest v7.0开始，配合pytest-dotenv插件，可内置使用--envfile支持。这是当前最轻量、兼容性最好的做法，不会侵入测试逻辑，变量仅在测试运行时注入os.environ，且支持多文件叠加。

具体操作分为三步：

• 安装：pip install pytest-dotenv
• 在项目根目录下新建.env.test文件，内容示例如下：

API_BASE_URL=https://staging.example.com
DB_NAME=test_db
DEBUG=true

• 运行测试时显式指定：pytest --envfile=.env.test tests/
• 测试中直接读取：os.getenv("API_BASE_URL")，无需额外import或setup

注意：若同时存在.env和.env.test，后者优先级更高。但建议不要依赖隐式加载，始终使用--envfile明确指定，以保证可控性。

灵活场景：在 conftest.py 中手动注入

若需要动态生成或条件化设置变量（例如根据pytest参数切换环境），.env文件可能不够灵活。此时可在conftest.py中使用pytest_configure钩子：

import os

def pytest_configure(config):
    os.environ.setdefault("API_BASE_URL", "https://local.dev")
    os.environ.setdefault("LOG_LEVEL", "DEBUG")

关键点在于使用setdefault而非直接赋值，以避免覆盖已有变量，否则会干扰本地调试或CI环境已设置的值。若担心污染，可配合pytest_unconfigure删除临时变量，但通常无需主动处理——进程退出后变量自动释放。

需要提醒的是：不建议在setup_method或fixture中反复设置，那样会导致不可预测的覆盖顺序，增加调试难度。

monkeypatch 与 fixture 的使用场景与边界

单个测试中使用monkeypatch.setenv()是安全的，但它仅作用于当前测试函数，无法统一管理跨测试的“固定环境”。若目标是让所有测试都运行在staging环境下，则不属于patch的适用场景——这是配置问题，而非模拟问题。

错误做法：使用@pytest.mark.parametrize给每个测试传递环境参数，导致配置分散、难以维护。正确的边界是：用monkeypatch测试“当ENV=prod时函数行为不同”，而非用来设置整套测试环境。

fixture方式（例如@pytest.fixture(autouse=True)）容易引发执行顺序问题，且无法被--envfile或CI变量覆盖，灵活性反而降低。

核心在于分清“固定环境”与“测试隔离”的区别：前者属于运行配置，应使用--envfile或pytest_configure；后者才是monkeypatch和fixture的适用领域。混用会导致配置漂移，尤其在CI中表现不一致，需要特别注意。