PyCharm无法识别Pytest测试套件，如何正确配置？

针对你在Ubuntu 22.04 + PyCharm Professional 2023.3.4中遇到的问题，按以下步骤配置Pytest运行对话框即可识别测试套件：

1. 打开Pytest运行配置 #

通过Run > Edit Configurations打开配置面板，点击左上角+号，选择pytest新建配置。

2. 关键配置项填写 #

• Name：自定义配置名称（如Project Tests），方便识别即可
• Target：根据测试范围选择：
  • 运行整个项目测试：选择All tests in directory，点击右侧文件夹图标选中项目根目录或专门的测试文件夹（如tests/）
  • 运行单个测试文件：选择Script path，选中目标测试文件（需符合pytest命名规范：文件名以test_开头或_test.py结尾）
  • 运行特定模块：选择Module name，输入模块名（如tests.test_auth）
• Working directory：必须设置为你在命令行中运行pytest时所在的项目根目录，路径错误会导致PyCharm找不到测试用例
• Python interpreter：选择与命令行一致的Python环境（比如虚拟环境的解释器，如venv/bin/python），确保依赖包和pytest版本与命令行匹配
• Additional arguments：如果命令行运行时带了参数（如-xvs、--tb=short），直接填入此处即可
• Environment variables（可选）：若测试需要特定环境变量，点击右侧省略号，添加PYTHONPATH并设置为项目根目录路径，确保测试模块能被正确导入

3. 额外检查项 #

• 确认测试文件/函数命名符合pytest规范：测试文件以test_开头或_test.py结尾，测试函数/类以test_开头
• 验证PyCharm全局测试配置：File > Settings > Tools > Python Integrated Tools，确认Testing下的Default test runner为pytest，且pytest路径指向当前环境的可执行文件（如venv/bin/pytest）
• 刷新项目索引：File > Invalidate Caches...，勾选Clear file system cache and local history后重启PyCharm，解决索引异常问题

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