pytest.warns必须用with上下文显式包裹触发警告的代码，否则警告未被捕获导致测试失败；它默认只匹配第一个警告，需用match参数或多次with块验证全部；类型需精确指定（如deprecationwarning而非userwarning），消息匹配推荐子串而非正则以避免转义问题；未触发预期警告时会明确报错“did not warn”。
pytest.warns 要捕获警告，必须在警告发生时主动进入上下文
直接调用被测函数但不包裹 pytest.warns()，警告会被抛出并导致测试失败（除非全局过滤），根本不会被捕获。它不是装饰器，也不是自动监听机制——你得显式用 with pytest.warns(WarningType) 包住触发警告的代码块。
- 正确写法：
with pytest.warns(DeprecationWarning): some_function_that_warns() - 错误写法：
some_function_that_warns()单独执行 → 测试直接报UserWarning: ...并失败 - 如果函数内部有多处警告，
pytest.warns()默认只匹配第一个；要检查全部，得传match或用多次with块
匹配具体警告类型时，别漏掉模块路径或继承关系
Python 的警告类型常来自不同模块，比如 FutureWarning 是内置的，但 scipy.optimize.OptimizeWarning 就得写全名。更常见的是误判继承关系：传 Warning 能捕获所有警告，但太宽泛；传 UserWarning 却可能漏掉实际发出的 DeprecationWarning（它是 Warning 的子类，但不是 UserWarning 的子类）。
python-script-generator
下载
快速生成专业的 Python 脚本和应用代码。一键创建完整项目结构，支持CLI、API、爬虫、Bot、Django等多种项目类型，包含完整的项目结构、配置文件、依赖管理、测试、README和文档。
- 查清实际警告类型最可靠方式：先让测试失败，看 stdout 输出的完整警告行，例如：
DeprecationWarning: old_api() is deprecated - 然后用对应类名：
pytest.warns(DeprecationWarning)，而不是pytest.warns(UserWarning) - 不确定时可用元组：
pytest.warns((DeprecationWarning, FutureWarning))
用 match 参数校验警告消息内容，但正则要小心转义
match 接收字符串（子串匹配）或正则对象，但默认是子串匹配，不是全文匹配。很多人以为写 match="deprecated" 就够了，结果因空格、括号或特殊字符没命中。
- 推荐优先用字符串子串：
pytest.warns(FutureWarning, match="will be removed in v2.0") - 要用正则时，记得
re.escape()处理含特殊字符的消息，例如警告含"func(x, y)"，直接写match=r"func\(x, y\)"或match=re.escape("func(x, y)") -
match不校验警告类型，只校验消息；类型和消息需分开确认
警告未触发时测试会静默通过？不，pytest.warns 会报错
如果代码没发出预期警告，pytest.warns() 会明确失败，提示类似 Failed: DID NOT WARN. No warnings raised.。这点和 pytest.raises() 行为一致，不是“无事发生就通过”。
- 这是好事——避免误判“警告已处理”，但要注意：某些警告被全局
warnings.filterwarnings()抑制后，pytest.warns就捕不到 - 若怀疑被过滤，可在测试开头加
warnings.resetwarnings()，或用-W default运行 pytest 强制显示所有警告 - 注意：
pytest.warns()不影响其他测试的警告过滤状态，但同一测试内多次使用需留意警告是否已被消费（比如第一次with捕获后，第二次再进同样代码不会重复触发）
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
