如何在不修改conftest.py的情况下在pytest中使用命令行参数

直接在测试文件中使用argparse不生效的核心原因是：pytest会在测试脚本加载前提前完成命令行参数解析，你的自定义参数会被pytest判定为非法参数直接抛出错误，不会传递到测试文件内的argparse逻辑中。

方案1：在测试文件内直接使用pytest原生钩子实现 #

pytest_addoption钩子并非只能定义在conftest.py中，写在单个测试文件内时仅对当前文件的测试用例生效，完全不需要修改全局配置。
示例代码如下：

import pytest

# 直接在测试文件内定义钩子添加自定义参数
def pytest_addoption(parser):
    parser.addoption("--file1", action="store", default="default_file1.txt", help="第一个文件的路径")
    parser.addoption("--file2", action="store", default="default_file2.txt", help="第二个文件的路径")

# 定义fixture读取参数，可直接被测试用例调用
@pytest.fixture(scope="session")
def file1_path(request):
    return request.config.getoption("--file1")

@pytest.fixture(scope="session")
def file2_path(request):
    return request.config.getoption("--file2")

# 测试用例直接注入fixture即可拿到参数
def test_file_content(file1_path, file2_path):
    with open(file1_path, encoding="utf-8") as f1, open(file2_path, encoding="utf-8") as f2:
        content1 = f1.read()
        content2 = f2.read()
    # 你的测试断言逻辑
    assert len(content1) > 0
    assert len(content2) > 0

运行命令：
pytest test_xxx.py --file1 ./test1.txt --file2 ./test2.txt

该方案优势：

• 符合pytest原生规范，执行pytest --help可以看到你添加的自定义参数说明
• 支持参数类型校验、默认值配置等能力
• 对现有测试逻辑侵入性低

方案2：使用环境变量传递参数（完全无pytest配置依赖） #

如果不想使用pytest的钩子逻辑，可以直接通过操作系统环境变量传递路径，不需要改动任何pytest相关配置：
示例代码如下：

import os

def test_file_content():
    # 读取环境变量，第二个参数为默认值
    file1_path = os.getenv("TEST_FILE1", "default_file1.txt")
    file2_path = os.getenv("TEST_FILE2", "default_file2.txt")
    
    with open(file1_path, encoding="utf-8") as f1, open(file2_path, encoding="utf-8") as f2:
        content1 = f1.read()
        content2 = f2.read()
    # 测试断言逻辑
    assert len(content1) > 0
    assert len(content2) > 0

运行命令：

• Linux/Mac环境：TEST_FILE1=./test1.txt TEST_FILE2=./test2.txt pytest test_xxx.py
• Windows cmd环境：set TEST_FILE1=./test1.txt && set TEST_FILE2=./test2.txt && pytest test_xxx.py
• Windows PowerShell环境：$env:TEST_FILE1="./test1.txt"; $env:TEST_FILE2="./test2.txt"; pytest test_xxx.py

该方案优势：

• 完全不需要接触pytest的配置逻辑，实现速度快
• 跨框架兼容，即使后续切换测试框架也不需要修改参数传递逻辑

内容的提问来源于stack exchange，提问作者Evan Brittain