应使用 pytest.warns() 上下文管理器捕获并断言警告，而非字符串匹配或 warnings.catch_warnings()；需显式启用 deprecationwarning（如 simplefilter("always", deprecationwarning)），并依据场景选择装饰器、上下文管理器或反向验证写法。
如何用 pytest 捕获并断言特定警告类型
pytest 本身不直接支持 assert warning 这种写法，但提供了 warnings 模块集成和专用上下文管理器，能精准验证警告是否被触发、类型是否匹配、消息是否符合预期。关键不是“有没有警告”，而是“有没有你预期的警告”。
常见错误是直接用 assert "deprecated" in str(warning)，这既不可靠（可能匹配到日志或异常消息），又绕过了 pytest 对警告的捕获机制，导致测试通过但实际警告被忽略。
- 必须用
pytest.warns()上下文管理器，它会捕获代码块中发出的所有匹配警告，并在退出时校验是否至少触发一次 - 传入警告类（如
DeprecationWarning）比字符串更安全：避免因消息微调导致误判 - 若函数内部多次发出同一警告，
pytest.warns()默认只检查是否发生，不校验次数；需手动检查warning_list长度
pytest.warns() 的三种典型用法对比
不同场景下写法差异直接影响可读性和健壮性。别硬套一种模式——比如对已知会抛警告的函数，直接装饰比嵌套 with 更干净；对需要检查警告属性的场景，必须解包 record。
-
装饰器用法（推荐用于整个测试函数）：
@pytest.mark.filterwarnings("error::DeprecationWarning")可把警告转为异常强制失败；或用@pytest.mark.filterwarnings("ignore::UserWarning")屏蔽无关警告 -
上下文管理器（最常用）：
with pytest.warns(DeprecationWarning) as record:后续可访问record[0].message和record[0].filename -
断言警告未发生（反向验证）：
with pytest.warns(None) as record:然后assert len(record) == 0，注意不能省略as record，否则无法获取空列表
为什么 warnings.catch_warnings() 在 pytest 中不推荐
原生 warnings.catch_warnings() 虽然能捕获，但它绕过 pytest 的警告配置（如命令行 --disable-warnings 或 filterwarnings ini 设置），导致本地跑通、CI 失败，或与团队统一警告策略冲突。
更隐蔽的问题是：它不会自动重置警告过滤器状态，若测试中途修改了全局过滤规则，可能污染后续测试。而 pytest.warns() 是隔离的、上下文感知的。
- 不要写
with warnings.catch_warnings(record=True) as w:+assert issubclass(w[0].category, FutureWarning) - 改用
with pytest.warns(FutureWarning) as record:，简洁且与 pytest 生态一致 - 如果必须检查警告堆栈（比如确认警告来自某行），用
record[0].lineno，而不是解析 traceback 字符串
常见陷阱：DeprecationWarning 默认被忽略
这是最常踩的坑——本地运行测试完全看不到 DeprecationWarning，pytest.warns(DeprecationWarning) 总是失败，不是代码问题，是 Python 默认行为。
- Python 3.7+ 默认过滤掉
DeprecationWarning（仅对模块顶层代码生效，但 pytest 测试函数属于此范围） - 必须显式启用：在测试文件顶部加
warnings.simplefilter("always", DeprecationWarning)，或在pyproject.toml中配置filterwarnings = ["default::DeprecationWarning"] - 另一种方式是启动 pytest 时加参数：
python -m pytest -W default::DeprecationWarning - 注意
UserWarning和FutureWarning默认不被过滤，所以它们的pytest.warns()通常直接可用
警告断言的本质是契约测试：你声明“这段代码在此上下文中应当发出这个警告”，而不是“它恰好没崩”。漏掉 simplefilter 或错用 catch_warnings，会让这种契约形同虚设。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
