用@pytest.mark.skipif跳过不兼容测试最常用可靠，它在收集阶段判断并跳过，避免语法错误导致崩溃；需注意版本边界（如match语句应以(3,10,0)为界）、显式指定CI测试版本、加-rs查看跳过摘要，并依据发布说明精准判断跳过时机。
用 pytest.mark.skipif 跳过不兼容的测试
直接在测试函数上加 @pytest.mark.skipif 是最常用、最可靠的方式。它在收集阶段就决定是否跳过，不会执行被跳过的测试体，避免因语法错误（比如用了高版本才支持的类型提示）导致整个测试套件崩溃。
常见错误是写成 skipif(sys.version_info 却忘了导入 <code>sys —— pytest 不自动注入它，必须显式 import。
- 判断 Python 版本必须用
sys.version_info，不能用sys.version字符串匹配（易出错） - 条件为
True时跳过，所以低版本要跳过新特性测试，就写sys.version_info -
reason参数必须提供，否则 pytest 会警告；建议写清楚“requires Python 3.9+”这类信息
@pytest.mark.skipif(sys.version_info < (3, 9), reason="requires Python 3.9+")
def test_new_syntax():
# Python 3.9 才支持的 dict union operator
assert {"a": 1} | {"b": 2} == {"a": 1, "b": 2}
在 conftest.py 中全局配置版本敏感 fixture
当多个测试需要共享同一套版本检查逻辑（比如都依赖 zoneinfo 模块），与其每个测试都写一遍 skipif，不如在 conftest.py 里定义一个 fixture，把版本判断封装起来。
注意：fixture 本身不会跳过测试，它只提供值；真正跳过仍需配合 skipif 或运行时 pytest.skip()。
立即学习“Python免费学习笔记（深入）”；
- 用
pytest.skip()在 fixture 内部做运行时跳过，比装饰器更灵活（比如能检查模块是否存在） - 如果 fixture 返回的是模块对象（如
zoneinfo），测试函数签名里声明它即可，pytest 自动注入 - 不要在 fixture 里 raise
SkipTest—— 应该用pytest.skip()，它才是 pytest 推荐的跳过方式
# conftest.py
import pytest
<p>@pytest.fixture
def zoneinfo_module():
if sys.version_info < (3, 9):
pytest.skip("zoneinfo not available before Python 3.9")
import zoneinfo
return zoneinfo
避免在测试函数内用 try/except 检查语法兼容性
有人会写 try: from typing import TypeGuard except ImportError: ... 来兜底，但这在低版本 Python 解析时就会失败——因为 TypeGuard 是 Python 3.12 新增的类型，3.11 及以下解释器根本无法成功 import 该语句，直接 SyntaxError，测试收集阶段就中断。
这种写法看似“兼容”，实则不可行。pytest 的收集流程要求所有测试文件能被目标 Python 解释器成功 import，否则整个 session 失败。
- 语法级特性（如
match/case、Self类型、type语句）绝不能出现在低版本解释器可执行的代码路径中 - 运行时缺失模块可用
try/except ImportError，但语法结构不行 - 若必须分路径，应通过
skipif完全隔离，而不是靠异常捕获绕过解析
CI 中验证多版本行为的一致性
本地开发时容易只测当前环境版本，但真实场景下，你的包可能被用户在 3.8–3.12 各个版本使用。CI 配置里必须明确列出多个 Python 版本，并确保跳过逻辑在各版本下行为一致。
一个典型坑是：用 sys.version_info >= (3, 10) 判断 match 语句支持，但在 Python 3.10 早期 alpha 版本中，match 还不稳定，实际应以 (3, 10, 0) 为界更稳妥。
- CI 的 Python 版本列表应覆盖你声明支持的最小和最大版本，中间至少加一个中间版本（如 3.9、3.11）
- 不要依赖
python -m pytest的默认行为——显式指定--tb=short和-v，方便快速定位哪个版本下哪个测试被跳过 - 跳过信息会出现在 pytest 输出里，但默认不显示
reason；加-rs才能看到 skipped summary
跳过逻辑本身很简单，难的是判断“该不该跳”——有些特性是语法层面硬性不兼容，有些是模块存在性问题，还有些是行为差异（比如 dict 迭代顺序保证从 3.7 开始）。这些细微差别得结合具体 Python 版本发布说明来确认，不能只看主次版本号。
