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
注意:过滤规则按注册顺序匹配,越靠前的越优先;建议在脚本开头或模块导入后立即设置。
立即学习“Python免费学习笔记(深入)”;
临时捕获警告做检查(测试/调试常用)
用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流程、容器部署或快速排查,无需修改源码。










