最稳妥的跳过方式是@ pytest.mark.skipif；它在测试收集阶段求值布尔条件，要求提供reason参数说明原因，避免用运行时操作（如网络请求），且能被CI/CD识别。
直接跳过不稳定的测试用例，用 @pytest.mark.skipif 最稳妥；@pytest.mark.skip 适合临时封存，但容易遗忘恢复。
为什么不用注释或 if False: 屏蔽测试函数
注释掉测试函数会导致 pytest 完全“看不见”它，后续想快速启用就得手动删注释、可能漏改；if False: 包裹函数体又会让 pytest 仍尝试收集该函数（可能报语法或作用域错误），且 IDE 会标出 unreachable code 警告。而 @pytest.mark.skipif 是 pytest 原生支持的声明式跳过，既保留在测试文件中、可被 CI/CD 工具识别，又明确表达了“跳过有原因”，日志里还能看到 reason 字段。
@pytest.mark.skipif 的 condition 到底怎么写才可靠
condition 必须是布尔表达式，且在 pytest 收集测试阶段就可求值——不能依赖运行时才生成的数据（比如 HTTP 请求结果、数据库查询）。常见安全写法包括：
- 检查环境变量：
@pytest.mark.skipif(os.getenv("CI") == "true", reason="CI 环境不稳定") - 检查 Python 版本：
@pytest.mark.skipif(sys.version_info - 检查模块是否可用：
@pytest.mark.skipif(importlib.util.find_spec("playwright") is None, reason="playwright 未安装") - 检查配置常量：
@pytest.mark.skipif(not config.USE_REAL_API, reason="仅限 mock 模式")
⚠️ 避免写类似 @pytest.mark.skipif(requests.get("https://api.test").status_code != 200, ...) —— 这会让 pytest 收集阶段就发起网络请求，失败则整个测试套件中断。
reason 参数不是可选的，漏写会报错
从 pytest 7.0 开始，@pytest.mark.skipif 的 reason 参数强制要求提供。不写会抛出 TypeError: skipif() missing 1 required keyword-only argument: 'reason'。这个设计倒逼你记录跳过依据，方便后续回溯。示例：
@pytest.mark.skipif(
os.getenv("SKIP_FLAKY") == "1",
reason="test_login_timeout 在高延迟网络下偶发失败，待重写等待逻辑"
)
def test_login_timeout():
...
reason 里建议写清“什么现象”“为什么跳”“后续谁来修”，而不是只写“临时跳过”。
跳过逻辑被绕过的典型场景
即使加了 @pytest.mark.skipif，以下情况仍可能导致用例实际执行：
- 用
pytest test_file.py::test_func单独运行该用例：pytest 不触发条件判断，直接执行（除非 condition 是常量 True） - condition 表达式本身抛异常（比如 keyerror、attributeerror），pytest 默认把它当 False 处理，用例照常跑——这反而掩盖了跳过逻辑缺陷
- 在 conftest.py 里用
pytest_runtest_makereporthook 手动修改结果状态，覆盖了 skip 标记
验证是否真跳过，最简单方法是加一句 print("I'm running!") 在测试函数开头，再运行完整测试集看输出；或者用 pytest -v 观察结果列是否显示 SKIPPED 而非 PASSED/FAILED。
真正难的是判断“该不该跳”——跳过掩盖问题，不跳又阻塞流水线。所以 reason 里那句“待重写等待逻辑”，比跳过动作本身重要得多。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
