怎样在Python中使用warnings模块过滤或捕获警告？-Python教程-PHP中文网

应使用 warnings.filterwarnings() 或 warnings.catch_warnings() 控制警告，因 warning 不是异常，try/except 无法捕获；其通过 warnings.showwarning() 输出到 stderr，且不同 python 版本默认行为差异大。

怎样在python中使用warnings模块过滤或捕获警告？

直接用 warnings.filterwarnings() 或 warnings.catch_warnings()，别依赖 try/except 捕获警告——警告不是异常，不会中断执行，也不会被 except Warning: 捕获。

为什么 `try/except Warning` 不起作用？

因为 Warning 类型的实例默认不触发异常流程，而是由 warnings 模块调用 warnings.showwarning() 输出到 stderr。即使你写了 except Warning:，Python 也不会进入该分支。

常见错误现象：

代码里写了 except Warning: 却完全没反应
警告照常打印，程序继续跑，但你以为“被捕获了”
误以为 DeprecationWarning 和 FutureWarning 默认会报错（其实只在某些环境下显示，比如交互式解释器）

用 `warnings.filterwarnings()` 精确控制警告行为

这是最常用、最灵活的方式，支持按类别、模块、行号甚至正则匹配消息内容来过滤。

关键参数说明：

action：可选 "ignore"、"error"（转为异常）、"always"（每次都显示）、"once"（同一条只显示一次）、"module"（同模块只一次）
category：指定警告类，如 DeprecationWarning、UserWarning，必须是 Warning 的子类
module：限制仅对某模块生效，例如 r"myproject\.utils"
message：支持正则字符串，比如 r".*invalid value.*"

示例：全局忽略所有 DeprecationWarning

python全能编程助手

SkillSub Pro - Python 题解与代码注释双功能技能功能概述SkillSub Pro - Python 题解与代码注释双功能技能是一项面向实际任务的技能，主要用于SkillSub Pro 是一个 Python 题解生成与代码注释的双功能合体技能，专为学生、算法学习者和开发者设计；✅ 一个技能，两种用途：；核心要点📝 题解模式：输入题目/题号，自动生成完整 Python 题解（含详细注释、解题思路、复杂度分析）；💬 注释模式：输入 Python 代码，自动添加详细中。它将相关步骤、

下载

warnings.filterwarnings("ignore", category=DeprecationWarning)

示例：把某个第三方库的特定警告转成异常（便于定位）

warnings.filterwarnings("error", message=".*numpy.*deprecated.*", category=FutureWarning, module="pandas")

用 `warnings.catch_warnings()` 临时捕获警告

适合测试或调试场景，需要显式启用 record=True 才能拿到警告记录列表。

注意点：

必须在 with 块内触发警告，否则捕获不到
catch_warnings() 默认不继承全局 filter 规则，需加 record=True 和/或 action="always" 才确保捕获
返回的是 WarningsRecorder 对象，其 list 属性是 WarningMessage 实例列表，每个含 message、category、filename、lineno

示例：验证某函数是否发出 UserWarning

import warnings
<p>with warnings.catch_warnings(record=True) as w:
warnings.simplefilter("always")  # 确保警告不被过滤
some_function_that_warns()
assert len(w) == 1
assert issubclass(w[0].category, UserWarning)
assert "expected message" in str(w[0].message)</p>

容易被忽略的兼容性细节

不同 Python 版本对警告的默认处理有差异：

Python 3.7+ 中，DeprecationWarning 默认**不显示**给终端用户（只对 __main__ 模块生效），但测试框架（如 pytest）可能开启它
FutureWarning 默认始终显示，面向终端用户
命令行启动时加 -W ignore::DeprecationWarning 可覆盖代码中的 filter 设置
使用 logging.captureWarnings(True) 可把警告重定向到 logging 系统，但要注意日志级别映射（Warning → WARNING，DeprecationWarning → WARNING，不是 DEBUG）