Pytest配置实战：高效管理测试标记与覆盖

该 pytest.ini 配置文件为"归藏层"项目定义了完整的测试框架行为，其核心配置与功能如下：

核心配置解析

配置类别	配置项	说明与作用
测试发现	`python_files`, `python_classes`, `python_functions`, `testpaths`	定义了测试文件、类、函数的命名模式以及搜索目录，确保 `pytest` 能正确发现并收集所有测试用例。
自定义标记	`markers`	声明了项目专用的测试分类标记（如 `unit`, `integration`, `slow`, `traceback` 等），用于对测试用例进行逻辑分组和选择性执行。
默认运行选项	`addopts`	设置了 `pytest` 的默认命令行参数。每次执行 `pytest` 时，这些选项会自动生效，无需在命令行重复输入。
超时控制	`timeout`, `timeout_method`	为所有测试用例设置全局超时限制（300秒），防止个别用例长时间挂起。
日志配置	`log_cli`, `log_cli_level`, `log_cli_format`, `log_cli_date_format`	配置测试运行时的实时日志输出格式和级别，便于调试。

关键配置详解

默认运行选项 (addopts)

此部分定义了项目的质量门禁 和默认工作流：

ini 复制代码

addopts =
    -v # 详细输出    --strict-markers            # 严格检查标记，防止未声明的标记被使用
    --tb=short                  # 使用简短的错误回溯信息 --maxfail=2                 # 遇到2个失败后停止测试
m "not slow"               # 默认跳过标记为 `slow` 的测试用例 --cov-report=html:./coverage/html  # 生成HTML覆盖率报告
    --cov-report=term-missing   # 在终端输出缺失覆盖的行 --cov=../guicang/core       # 指定计算覆盖率的源码模块    --cov=../guicang/l2_explanation
    --cov-fail-under=75         # 设置覆盖率门槛，低于75%则测试失败

m "not slow" ：实现了快速反馈循环 。开发者日常运行 pytest 时，会自动跳过耗时较长的测试，提升效率。
--cov-fail-under=75 ：设定了覆盖率质量红线。如果整体行覆盖率低于75%，测试套件将返回失败状态，用于CI/CD流程中阻断低质量代码的合入。
--strict-markers ：强制要求所有在测试中使用的 @pytest.mark.xxx 装饰器标记都必须在 markers 部分声明，避免了拼写错误和未定义的标记。

自定义标记 (markers)

标记系统是组织测试的核心，支持灵活的执行策略：

python 复制代码

# 示例：在测试用例中使用标记
import pytest

@pytest.mark.unit
@pytest.mark.fast
def test_addition():
    assert 1 + 1 == 2

@pytest.mark.integration
@pytest.mark.slow
def test_database_connection():
    # ... 耗时操作 pass

@pytest.mark.traceback
def test_traceback_algorithm():
    # ... 任务A相关测试 pass

通过命令行可以按需执行特定类型的测试：

bash 复制代码

# 仅运行单元测试
pytest -m unit

# 运行除慢速测试外的所有测试（与默认配置一致）
pytest -m "not slow"

# 运行任务A相关的所有测试
pytest -m traceback

# 同时满足多个标记的测试pytest -m "unit and fast"

与 run_coverage.sh 脚本的协同

该 pytest.ini 文件与之前提供的 run_coverage.sh 脚本共同构成了项目的测试基础设施：

pytest.ini 定义了静态的、项目级的默认配置，是测试框架行为的基石。
run_coverage.sh 是一个动态的、封装好的执行入口 。它基于 pytest.ini 的配置，并通过脚本参数（如 --full, --ci）在运行时覆盖或扩展某些默认行为（例如，在 --full 模式下覆盖 -m "not slow" 的过滤条件）。

配置验证与覆盖规则

配置文件位置 ：pytest.ini 应放置在项目根目录或 tests/ 目录下，pytest 会自动识别并加载。
优先级 ：命令行参数具有最高优先级，会覆盖 pytest.ini 中 addopts 的相同设置。例如，执行 pytest -m slow 会覆盖配置中的 -m "not slow" 。
标记严格性 ：由于配置了 --strict-markers，任何使用未在 markers 段落中声明的标记的测试，在运行时都会报错，这有助于维护标记列表的整洁和一致。

Pytest配置实战：高效管理测试标记与覆盖

核心配置解析

关键配置详解

配置验证与覆盖规则

参考来源