### 解决Pytest运行时卡在Collecting阶段的问题 当Pytest运行时卡在`collecting...`阶段，通常是因为测试文件、类或函数命名不符合默认规则，或者配置文件存在问题。以下是可能的原因及其解决方案： #### 1. 文件名、类名和函数名的命名规则 Pytest 默认会按照特定的命名约定来识别哪些文件、类和函数作为测试目标。如果这些名称不匹配，默认情况下不会被收集到测试集中。 - 测试文件应命名为 `test_*.py` 或者 `*_test.py`[^4]。 - 类名应以 `Test` 开头，并且不应继承自任何其他类（除非是 `unittest.TestCase` 的子类）。 - 函数名应以 `test_` 开头。 如果不遵循上述规则，则可能导致 Pytest 无法找到可执行的测试用例，从而停留在 `collecting...` 阶段。 #### 2. 修改 pytest.ini 配置文件 可以通过创建或修改 `pytest.ini` 文件来自定义命名规则。例如，在某些项目中，可能会因为配置错误而导致问题。以下是一个典型的 `pytest.ini` 文件示例： ```ini [pytest] python_files = test_*.py *.py # 添加更多文件模式 python_classes = Test* # 定义类前缀 python_functions = test_* # 定义函数前缀 ``` 如果当前项目的 `pytest.ini` 文件存在错误配置，比如缺少通配符或拼写错误，也可能导致此问题。因此建议检查并更正该文件的内容。 #### 3. 插件冲突或其他环境因素 有时第三方插件可能干扰正常行为。尝试禁用所有插件重新运行命令以排除这种可能性： ```bash pytest --disable-plugin=all ``` 另外，确保已正确安装必要的依赖项以及版本兼容性良好。例如，对于 HTML 报告功能，需额外安装相关扩展包： ```bash pip install pytest-html pytest-logger ``` 这一步骤有助于确认是否存在因缺失组件引发的功能异常情况[^2]。 #### 4. 调试与日志分析 为了进一步诊断具体原因，可以启用详细的调试输出查看内部处理过程： ```bash pytest -ra -v ``` 其中 `-r` 参数用于指定失败重跑策略而 `-v` 提供更高层次的信息展示；通过观察终端打印的消息能够定位潜在瓶颈所在位置[^3]。 --- ### 示例代码调整 假设有一个简单的 Python 文件未按标准命名方式编写如下所示： ```python def add(a, b): return a + b def check_addition(): assert add(1, 2) == 3 ``` 将其改造成符合规范的形式之后再执行即可解决问题： ```python # 文件名为 test_example.py def add(a, b): return a + b def test_check_addition(): # 更改为以 'test_' 开始的方法名 assert add(1, 2) == 3 ``` ---