pytest.mark.skipif没生效最常见的原因是平台判断逻辑错误：sys.platform在macOS返回"darwin"而非"macos"，Windows为"win32"，Linux为"linux"；推荐改用platform.system()（返回"Darwin""Windows""Linux"）并注意大小写和CI环境差异。
pytest.mark.skipif 为什么没生效？检查平台判断逻辑是否正确
最常见的原因是 sys.platform 或 platform.system() 返回值和你写的字符串不匹配。比如在 macOS 上，sys.platform 是 "darwin"，不是 "macos" 或 "mac"；Windows 是 "win32"，Linux 是 "linux"。用错就等于白写条件。
推荐统一用 platform.system()，它返回 "Windows"、"Linux"、"Darwin"（首字母大写），语义更清晰：
import platform
import pytest
@pytest.mark.skipif(platform.system() == "Windows", reason="Only runs on non-Windows")
def test_something():
assert True
- 别直接硬编码
"win32"，除非你明确依赖sys.platform的行为 - 如果测试跑在 CI（如 GitHub Actions）里，注意 runner 的实际系统名可能和本地不同（例如
ubuntu-latest返回"Linux"） - 条件表达式必须是顶层可求值的——不能调用未导入的函数，也不能引用测试函数内部变量
如何跳过多个平台？用 or 连接比嵌套 skipif 更可靠
想让某个测试只在 Linux 上运行，其他平台都跳过？别写两层 @pytest.mark.skipif，容易漏判或冲突。直接在一个条件里用布尔逻辑：
@pytest.mark.skipif(
platform.system() not in ["Linux"],
reason="Only supported on Linux"
)
def test_linux_only():
...
- 避免写成
@pytest.mark.skipif(...); @pytest.mark.skipif(...)—— pytest 不会合并多个 skipif 的逻辑，而是按顺序执行，后一个可能覆盖前一个 - 需要排除 Windows 和 macOS？写
platform.system() in ["Windows", "Darwin"]比两个独立 skipif 更直观 - 注意字符串比较区分大小写：
"darwin" != "Darwin"
CI 环境下 platform.system() 返回值异常？优先检查 Python 启动环境
在 GitHub Actions 或 GitLab CI 中发现 platform.system() 返回空或意外值，大概率不是 pytest 问题，而是 Python 解释器本身没正常初始化。常见诱因：
立即学习“Python免费学习笔记（深入）”；
- 使用了精简版 Python 镜像（如
python:slim），缺少部分系统库，导致platform模块行为异常 - 容器内挂载了错误的
/proc或/sys，干扰底层系统识别 - 通过
pyenv或conda安装的 Python 在非交互式 shell 下未正确加载环境
临时验证方式：在测试前加个 fixture 打印真实值：
@pytest.fixture(autouse=True)
def debug_platform():
import platform
print("Platform system:", repr(platform.system()))
若输出为 None 或空字符串，说明环境有问题，得换基础镜像或修复启动命令。
skipif 条件里能用 os.environ 吗？可以，但要注意 pytest 收集阶段就求值
是的，os.environ 可以用，比如跳过某些 CI 特定环境下的测试：
import os
import pytest
@pytest.mark.skipif("GITHUB_ACTIONS" not in os.environ, reason="Only in GitHub Actions")
def test_ci_only():
...
但关键点在于：这个判断发生在 pytest **收集测试项时**，不是运行时。所以：
- 如果你在命令行用
GITHUB_ACTIONS=1 pytest ...，它有效；但用export GITHUB_ACTIONS=1 && pytest ...也有效，因为子进程继承了环境变量 - 如果在测试函数内部修改
os.environ，对 skipif 完全没影响——它早就判断完了 - 跨平台脚本中慎用
os.name == "nt"，它只区分 “Windows vs 非Windows”，不如platform.system()明确
真正容易被忽略的是：skipif 的条件表达式在导入测试模块时就会执行一次，如果里面包含有副作用的操作（比如读文件、发 HTTP 请求），不仅慢，还可能导致收集失败。
