Python警告模块用法：忽略与捕获实战指南

Python的warnings模块用于发出非致命警告，不能用try/except捕获；需用filterwarnings、simplefilter忽略，catch_warnings(record=True)临时捕获，或通过-W参数及PYTHONWARNINGS环境变量控制。

Python的warnings模块用于发出非致命警告信息，比如弃用提醒、可疑写法提示等。它不中断程序执行，但默认会把警告打印到标准错误输出——这在测试、部署或日志分析中常需控制：有时要忽略掉干扰项，有时要捕获并做处理。

为什么不能用try/except捕获警告？

警告不是异常，不会触发except分支。直接写except Warning:是无效的。必须通过warnings模块的机制来管理。

忽略特定警告（简单实用）

用warnings.filterwarnings()或warnings.simplefilter()可全局屏蔽某类警告：

• warnings.filterwarnings("ignore", category=DeprecationWarning) —— 忽略所有弃用警告
• warnings.filterwarnings("ignore", message=".*divide by zero.*", category=RuntimeWarning) —— 按正则匹配忽略特定提示
• warnings.simplefilter("ignore", UserWarning) —— 简洁写法，忽略全部UserWarning

注意：过滤规则按注册顺序匹配，越靠前的越优先；建议在脚本开头或模块导入后立即设置。

临时捕获警告做检查（测试/调试常用）

用warnings.catch_warnings(record=True)上下文管理器，能获取所有触发的警告对象：

• 参数record=True让警告被记录进列表，而非打印
• 每个记录是warnings.WarningMessage实例，含message、category、filename、lineno等属性
• 适合单元测试中验证函数是否如期发出警告

示例：

import warnings

with warnings.catch_warnings(record=True) as w:
    warnings.warn("This is a test warning", UserWarning)
    assert len(w) == 1
    assert issubclass(w[0].category, UserWarning)
    assert "test warning" in str(w[0].message)

运行时控制警告行为（命令行与环境）

不改代码也能干预警告输出：

• 启动Python时加-W ignore：忽略全部警告
• -W error：把警告转为异常（便于定位问题）
• -W once：同类警告只显示一次
• 设置环境变量PYTHONWARNINGS=ignore::DeprecationWarning

这些方式适合CI流程、容器部署或快速排查，无需修改源码。