Pytest测试套件无法识别测试用例问题排查求助

• 确认PyCharm测试运行器配置
  打开File > Settings > Tools > Python Integrated Tools，在Testing模块里将默认测试运行器设置为pytest，而非unittest。同时检查运行配置的目标路径，确保指向包含测试用例的文件或目录，而非空路径或错误路径。

• 严格核对测试命名规范
  即使你已用test_前缀，再逐一确认：

  • 测试文件名必须以test_开头或_test.py结尾
  • 测试类需以Test开头，且不能定义__init__方法
  • 测试方法必须以test_作为前缀，比如test_user_login()

• 验证pytest环境安装
  在项目终端执行pip list，检查当前虚拟环境中是否安装了pytest。若未安装，执行pip install pytest完成安装。同时通过File > Settings > Project: [你的项目名] > Python Interpreter确认PyCharm使用的是正确的虚拟环境。

• 排查测试文件位置与语法问题

  • 若测试用例放在自定义目录，在项目根目录创建pytest.ini文件，指定测试路径：

    [pytest]
    testpaths = tests/  # 替换为你的测试目录路径
    

  • 在终端直接运行pytest命令，查看详细报错信息——如果测试文件存在语法错误、导入失败等问题，pytest会直接跳过该文件，导致PyCharm显示Empty suite。

• 清理IDE缓存并重启
  执行File > Invalidate Caches... > Invalidate and Restart，清理PyCharm缓存后重启，缓存异常也可能导致测试用例识别失败。

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