pytest跳过测试用例：skip和skipif使用详解

本文深入解析了 pytest 中 `@pytest.mark.skip` 和 `@pytest.mark.skipif` 的正确用法与常见陷阱：前者无条件跳过测试，后者需在测试收集阶段（即模块导入时）即可求值的条件表达式，否则会静默失效；强调所有依赖模块必须显式导入、避免运行时变量和异常调用，并推荐使用 `sys.platform` 判断系统类型；同时覆盖类级、模块级跳过写法及 CI 环境下通过环境变量精准控制跳过的实战技巧——掌握这些细节，才能让跳过逻辑真正生效，避免看似配置了却仍执行的“幽灵测试”问题。

直接说结论：用 @pytest.mark.skip 无条件跳过，用 @pytest.mark.skipif 按条件跳过——但条件表达式必须在导入时就可求值，不能依赖运行时才确定的变量（比如测试函数内部的局部变量）。

为什么 skipif 条件写错就静默失效？

很多人写 @pytest.mark.skipif(sys.platform == "win32", reason="only on Linux")，结果测试照常跑，没跳过。问题出在：pytest 在收集测试阶段（import 阶段）就解析 skipif 的条件，此时 sys 是可用的，但如果你引用了尚未导入的模块、或用了未定义的变量（比如 os 却没 import os），pytest 会直接忽略这个 mark，不报错也不跳过。

实操建议：

• 所有 skipif 中用到的模块、常量、函数，必须在测试文件顶部显式 import
• 条件表达式里避免调用可能抛异常的函数（比如 shutil.which("gcc")），它会在收集阶段执行，失败会导致跳过逻辑中断
• 不确定时，先用 python -m pytest --collect-only 看是否真被标记为 skipped

skipif 判定系统类型最稳的方式

判断平台别硬写字符串比较，用 sys.platform 或 platform.system() 都行，但要注意差异：

• sys.platform 返回 "linux" / "win32" / "darwin"，轻量、可靠，推荐
• platform.system() 返回 "Linux" / "Windows" / "Darwin"，首字母大写，且调用稍重（内部做了更多探测）
• 别混用：比如 @pytest.mark.skipif(platform.system() == "linux", ...) 永远不会触发（大小写不匹配）

正确示例：

import sys

@pytest.mark.skipif(sys.platform != "linux", reason="only runs on Linux")
def test_linux_only():
    assert True

想跳过整个类或模块，怎么写？

可以，但语法位置和作用域容易搞错：

• 加在类定义上方 → 整个类所有测试方法都被跳过
• 加在模块顶部（任何 def test_... 之前）→ 整个模块被跳过（pytest 3.7+ 支持）
• 加在函数内部或 if 块里 → 无效，pytest 不识别
• 多个 mark 可叠加，比如同时用 skipif 和 xfail，但注意后者优先级更高

模块级跳过示例（放文件最开头）：

import sys
pytestmark = pytest.mark.skipif(sys.platform == "win32", reason="no Windows support")

真正麻烦的是跨环境 CI 场景：本地开发是 macOS，CI 是 Linux，但某个测试只该在 CI 跳过——这时得靠环境变量，比如 @pytest.mark.skipif(os.getenv("CI") == "true", ...)，记得提前 import os。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《pytest跳过测试用例：skip和skipif使用详解》文章吧，也可关注golang学习网公众号了解相关技术文章。