如何配置tox默认带参数运行pytest但直接运行pytest时不生效？

要实现「tox默认带-n 2运行pytest，直接执行pytest时无默认参数」的需求，核心思路是让tox直接指定带参数的pytest命令，而非依赖pytest的全局配置文件，这样就能彻底隔离两种运行场景的参数。具体操作如下：

1. 清理冲突配置 #

• 如果之前在tox.ini里写过[pytest]小节（比如设置addopts = -n 2），建议直接删除这部分内容，避免和直接运行pytest的配置冲突。
• 保留pytest.ini用于直接运行pytest的全局配置（比如测试路径、标记规则等），但不要在其中添加-n 2参数。

2. 正确配置tox.ini #

在tox.ini的[testenv]小节中，显式指定带参数的pytest命令，示例配置如下：

[tox]
envlist = py39, py310, py311  # 根据你的项目支持的Python版本调整

[testenv]
deps =
    pytest
    pytest-xdist  # 必须安装这个插件，-n参数由它提供
commands =
    pytest -n 2 {posargs}  # 核心配置：tox运行时自动带上-n 2

配置细节说明： #

• commands = pytest -n 2 {posargs}：这行是关键——tox执行测试时，会直接调用带-n 2的pytest命令。{posargs}是tox的内置变量，允许你临时传递额外参数（比如运行tox -- -x会把-x传给pytest），也支持临时覆盖-n参数（比如tox -- -n 4会用-n 4替代默认的-n 2）。
• deps中必须包含pytest-xdist，否则tox运行时会因找不到-n参数而报错。

3. 验证效果 #

• 直接运行pytest：只会读取pytest.ini的配置（如果存在），不会自动带上-n 2，符合预期。
• 运行tox：tox会在每个虚拟环境中执行pytest -n 2，实现并行测试。
• 临时调整参数：如果需要单次修改并行数，运行tox -- -n 4即可，{posargs}会传递并覆盖默认参数。

为什么之前的配置会出问题？ #

• 若你之前在tox.ini里设置[pytest] addopts = -n 2，pytest会把这当成全局配置——无论通过tox还是直接运行，都会加载该参数，导致直接运行pytest也带-n 2。
• 添加pytest.ini后，pytest会优先读取该文件的配置，忽略tox.ini里的[pytest]小节，所以tox的配置会失效。而我们的方案让tox直接执行带参数的命令，绕过了pytest的全局配置读取，完美解决冲突。

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