推荐在测试函数内用pytest.skip()动态跳过：先检查os.getenv("run_integration") != "1"，再调用pytest.skip()，确保运行时判断、调试清晰、兼容ci环境变量空字符串等边界情况。
pytest中用skipif读取环境变量的正确写法
直接在装饰器里调用os.getenv()会失败——因为pytest在收集阶段就解析@pytest.mark.skipif，此时模块级代码已执行，但环境变量可能还没被加载或值为空字符串，导致条件误判。
必须把环境变量检查逻辑延迟到测试运行时，而不是装饰器求值时。最稳妥的方式是用pytest.importorskip配合惰性判断，或者改用pytest.skip()在函数体内手动跳过。
推荐做法：在测试函数开头显式检查，配合pytest.skip()。这样逻辑清晰、调试方便，且能准确响应运行时环境变化。
-
os.getenv("CI") == "true"比os.environ.get("CI")更安全，避免KeyError - 不要写
@pytest.mark.skipif(os.getenv("SKIP_SLOW"), reason="...")——这会在导入时就求值，永远跳过或永远不跳 - 若必须用
skipif装饰器，只能传一个可调用对象（如lambda），但可读性差，不推荐
使用pytest.skip()在测试内部动态跳过
这是最灵活、最易调试的方式。你可以在任意位置检查环境变量，甚至结合其他条件（比如文件是否存在、端口是否可用）再决定是否跳过。
import os
import pytest
<p>def test_api_integration():
if os.getenv("RUN_INTEGRATION") != "1":
pytest.skip("Skipping integration test: RUN_INTEGRATION not set to '1'")</p><h1>实际测试逻辑...</h1><pre class="brush:php;toolbar:false;"><code>assert True</code>
- 支持任意Python表达式，比如
not os.path.exists("/tmp/testdb.sqlite") - 报错信息里会显示跳过原因，便于CI日志排查
- 不会影响pytest的测试收集流程，即使环境变量缺失也不会报错
如何让skipif真正“动态”起来
如果坚持用@pytest.mark.skipif装饰器，唯一合法方式是传入一个**callable**，它在每个测试执行前被调用。注意：不是字符串条件，也不是立即求值的布尔值。
import os
import pytest
<p>def _should_skip_slow():
return os.getenv("SKIP_SLOW") == "1"</p><p>@pytest.mark.skipif(_should_skip_slow, reason="SKIP_SLOW=1")
def test_slow_algorithm():
...
</p>
- 函数名必须以
_开头（避免被pytest当成测试函数收集） - 返回
True表示跳过，False表示执行 - 不能带参数，pytest只调用它不传任何参数
- 每次测试运行前都会重新调用该函数，所以能响应环境变量变化
常见陷阱和兼容性注意点
不同运行环境对环境变量大小写、空格、引号处理不一致，尤其Windows cmd vs Linux shell vs GitHub Actions。别假设os.getenv("DEBUG")一定返回"True"或"1"。
- 用
os.getenv("MODE", "").lower().strip()统一预处理再比较 - CI系统（如GitHub Actions）有时会把
secrets设为空字符串而非未定义，is None判断不可靠 - pytest 7+ 对
skipifcallable 的支持稳定，但老版本（如5.x）可能不支持，建议升级 - 如果测试被
skipif跳过，它不会出现在--tb=short的traceback里；而pytest.skip()会显示为“skipped”状态并打印reason
真正动态的关键，是把判断时机从“导入时”挪到“运行时”。其它都是围绕这个核心的语法适配。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
