PyCharm GUI运行pytest正常，终端无参调用pytest无法收集测试文件

核心原因 #

pytest 无参数执行时默认遵循以下测试发现规则，绝大多数此类问题都是项目配置不符合默认规则导致：

• 自动搜索当前工作目录下文件名匹配 test_*.py 或 *_test.py 的文件作为测试文件
• 你的测试文件命名为test.py，不在默认匹配规则范围内；手动指定文件路径执行时pytest会跳过命名规则校验，所以pytest tests/test.py可以正常执行
• PyCharm GUI运行时自带自定义测试识别规则，因此不受默认规则限制
• 小概率原因：项目根目录的.gitignore、.pytestignore文件排除了tests目录或test.py文件

解决方案 #

方案1：修改测试文件命名（推荐） #

将tests目录下的test.py重命名为符合默认规则的名称，例如test_sample.py，修改后直接在根目录执行pytest即可正常收集用例。

方案2：新增pytest配置适配现有命名 #

如果不想修改现有文件名，在项目根目录新建pytest.ini配置文件，添加以下内容：

[pytest]
# 扩展测试文件匹配规则，加入test.py
python_files = test.py test_*.py *_test.py
# 指定测试搜索目录为tests，提升搜索效率
testpaths = tests

配置保存后，无参数执行pytest即可正常识别测试文件。

验证方法 #

修改完成后在项目根目录执行pytest -v，可以看到test_one用例被正常收集并执行。

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