pragma: no cover 可跳过单行或代码块，需严格格式（含空格、右对齐）；全局排除用 pyproject.toml 的 cov_ignore 或 pytest.ini 的 omit；@pytest.mark.skip 不影响覆盖率统计；验证需用 --cov-report=term-missing 并检查 .coverage 文件。
如何用 # pragma: no cover 注释跳过单行或代码块
pytest-cov 本身不支持按条件动态排除，但能识别标准的 # pragma: no cover 注释。它会在生成覆盖率报告时直接忽略该行或整个代码块（如函数、if 分支、try/except 块）。
常见错误是写成 # pragma: nocover（少空格）或 # NOCOVER（大小写/格式不符），这些都不会被识别。
- 单行跳过：
return None # pragma: no cover - 函数整体跳过：在
def行后紧跟注释，且缩进对齐 - 跳过整个 if 分支：在
if行后加注释，且所有分支语句（包括else）都需显式标注，否则可能只跳过部分 - 注意：注释必须紧贴代码右侧，中间不能有其他字符（如多余空格或分号）
如何通过 pytest.ini 或 pyproject.toml 配置全局排除路径和文件
排除整个文件或目录比逐行注释更高效，尤其适用于测试文件、配置文件、__main__.py 或自动生成的代码。
推荐优先使用 pyproject.toml（现代项目主流），若用 pytest.ini，确保其位于项目根目录且被 pytest 正确加载（可通过 pytest --help 查看是否读取到）。
-
pyproject.toml中写法：[tool.pytest.ini_options] cov_ignore = ["tests/", "migrations/", "manage.py"]
-
pytest.ini中对应项为：omit = tests/ migrations/ manage.py - 路径支持 glob 模式（如
**/migrations/**），但部分旧版本 pytest-cov 不支持，建议用明确路径 - 注意：这些配置只影响覆盖率统计，不影响测试执行本身
为什么 @pytest.mark.skip 和 pytest.skip() 无法排除覆盖率
这是最容易踩的坑：用 @pytest.mark.skip 跳过的测试函数，或运行时调用 pytest.skip() 的测试，仍会被 pytest-cov 计入“已执行代码”——因为测试函数本身被导入并解析了，只是没运行其中的语句。
安全 Python 代码沙箱：在隔离的沙箱中执行任意 Python 代码，预装 requests、NumPy、pandas 库。返回 stdout、stderr。
换句话说，覆盖率统计的是源码行是否被 Python 解释器执行过，不是“是否进入测试逻辑”。所以跳过测试 ≠ 跳过覆盖。
- 真正想排除某段业务逻辑的覆盖，必须用
# pragma: no cover标在那段逻辑上，而不是标在测试里 - 如果某函数只被跳过的测试调用，而生产代码中完全不调用它，那它本就不该存在；此时应删掉函数，而非靠跳过测试来掩盖
- 临时调试用的
print()或logging.debug()行，也建议加# pragma: no cover，避免拉低覆盖率数字
如何验证 exclude 是否生效
光改配置不验证，很容易以为排除成功，实际却没起作用。最可靠方式是运行带详细输出的覆盖率命令：
pytest --cov=src --cov-report=term-missing —— 这会列出所有未覆盖的行，并标明是否被标记为 pragma: no cover（显示为 “missing” 但带括号注明 (no cover)）。
- 如果某行写了
# pragma: no cover却仍出现在 missing 列表中，说明注释格式错误或位置不对（比如写在空行、注释行、或缩进不匹配） - 检查
.coverage文件是否残留旧数据：运行前加--cov-reset或手动删掉该文件 - 确认
cov_fail_under等阈值设置没掩盖真实结果；先关掉阈值再验证排除效果
实际项目里，# pragma: no cover 和 cov_ignore 配合使用最稳妥：前者处理零星难测逻辑（如 OS 特定分支、异常兜底），后者处理结构性排除（如测试目录）。别指望 pytest-cov 自动识别“无用代码”，它只认明确指令。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
