在VS Code中调试pytest时如何正确传入命令行参数？

问题根因 #

你当前使用的"purpose": ["debug-test"]配置是VS Code用来关联测试调试的特殊标识，但这种模式下，VS Code会通过自身的测试运行器启动pytest，并不会直接使用你配置的args参数，导致自定义的--csvfile和--skip无法被pytest接收。

两种可行解决方案 #

方案1：直接以模块方式启动pytest（推荐用于临时调试特定测试） #

修改launch.json，创建一个专门的pytest调试配置，绕过VS Code的测试运行器，直接传递参数给pytest：

{
    "name": "Python: Pytest 带参数调试",
    "type": "debugpy",
    "request": "launch",
    "module": "pytest",
    "args": [
        "${file}",  // 当前打开的测试文件，可替换为具体测试路径如"tests/test_example.py"
        "--csvfile=..\\example.csv",
        "--skip", "1"
    ],
    "console": "integratedTerminal",
    "justMyCode": false
}

注意：去掉--csvfile值的单引号，否则Windows系统会将带引号的字符串视为完整路径，导致文件找不到。调试时选择这个新配置即可。

方案2：全局配置pytest默认参数（适合常用固定参数） #

如果这些参数是你日常测试常用的，可以直接在VS Code的settings.json中配置，这样运行和调试所有测试都会自动带上参数：
打开settings.json（快捷键Ctrl+,），添加以下配置：

"python.testing.pytestArgs": [
    "--csvfile=..\\example.csv",
    "--skip", "1"
]

如果需要只针对特定测试文件生效，可以在参数列表中添加文件路径，比如"${file}"。

验证参数是否生效 #

可以在conftest.py中添加一行代码打印命令行参数，确认是否被正确传递：

import sys

def pytest_addoption(parser):
    print("当前命令行参数:", sys.argv)  # 打印参数用于验证
    parser.addoption(
        "--csvfile", action="store", default=None)
    parser.addoption("--skip", action="store", default=None)

内容的提问来源于stack exchange，提问作者Matt S