应使用 sys.platform == "win32" 判断跳过 Windows 测试，因其是启动时确定的稳定常量；避免用 platform.system() 或 os.name，防止收集阶段异常或误判。
怎么用 pytest.mark.skipif 跳过 Windows 上跑不了的测试
直接看判断逻辑：pytest.mark.skipif 的条件写成布尔表达式，为 True 就跳过。想在 Windows 跳过，就写 sys.platform == "win32"；想只在 Linux 运行，就写 sys.platform != "linux"。
常见错误是拿 os.name 判断——它返回 "nt" 或 "posix"，但 pytest 官方文档明确推荐用 sys.platform，因为更稳定（比如 macOS 也是 "darwin"，而 os.name 统一返回 "posix"，区分不开）。
- 必须提前
import sys，否则条件里用sys.platform会报NameError - 条件里不要调用函数（如
platform.system()），pytest 在收集阶段就求值，此时部分模块可能未完全加载 - 字符串比较用
==，别用in模糊匹配（比如"win" in sys.platform在旧版 Python 可能误判 Cygwin）
import sys
import pytest
@pytest.mark.skipif(sys.platform == "win32", reason="Only runs on Unix-like systems")
def test_unix_only():
assert True
为什么 skipif 条件里不能写 platform.system() == "Darwin"
表面看 platform.system() 更直观，但它在 pytest 收集测试时可能触发异常或返回意外值——比如某些容器环境里 platform.system() 会 fallback 到空字符串或抛 OSError，导致整个测试收集失败，而不是安静跳过。
sys.platform 是 Python 启动时确定的常量，安全、轻量、无副作用。macOS 对应 "darwin"，Linux 是 "linux"，Windows 是 "win32"（哪怕你用 64 位 Python）。
立即学习“Python免费学习笔记（深入）”；
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
- 别信
platform.uname().system，它和platform.system()一样有运行时风险 - 如果真要兼容旧系统（比如 Python 2.7），
sys.platform依然可用，无需降级方案 - 条件里可以组合逻辑，比如
sys.platform in ("win32", "cygwin")，但一般只加"win32"就够了
跳过整个测试类时，skipif 放哪儿才生效
必须直接装饰 class 语句本身，不是放在类里面，也不是放在 __init__ 或 setup_method 里。
常见错误是把 @pytest.mark.skipif(...) 写在类定义下方、方法上方，那只会作用于紧挨着的那个方法，不是整个类。
- 正确位置：紧贴
class TestSomething:上一行 - 如果类里混着跨平台和非跨平台测试，别整类跳过，改用单个函数加
@skipif - 类被跳过后，它的
setup_class和teardown_class都不会执行
import sys
import pytest
@pytest.mark.skipif(sys.platform != "darwin", reason="macOS-only integration test")
class TestMacOnly:
def test_say_hello(self):
assert True
CI 环境里 skipif 不生效？检查 pytest 版本和导入时机
Pytest 5.4+ 才完整支持在条件中使用 sys.platform 等内置变量；老版本（如 4.x）可能静默忽略或报错。另外，如果测试文件顶部没 import sys，而条件又写在模块级，就会在收集阶段崩掉——不是跳过，是直接中断。
- CI 中建议固定 pytest 版本，比如
pytest>=7.0.0，避免因 CI 镜像自带旧版导致行为不一致 - 条件里避免引用本地配置模块（如
from myconf import IS_CI），它们可能还没加载 - 用
pytest --collect-only先验证跳过逻辑是否被识别：跳过的测试会显示skipped，而不是collected
最麻烦的情况是条件依赖环境变量（比如 os.getenv("RUN_LINUX_TESTS") == "1"），这时务必确认 CI 的环境变量已透传，且大小写、空格都对得上——这种问题往往比平台判断更难排查。
