python warnings模块用于发出非致命警告，如弃用提醒；通过warn()触发、上下文管理器临时忽略、命令行或filterwarnings全局配置、catch_warnings(record=True)捕获分析。
Python 的 warnings 模块用于发出非致命警告信息，比如弃用提醒、可疑写法提示等。它不中断程序执行，但能帮助开发者提前发现潜在问题。合理使用警告机制，既能保持开发时的敏感度，又能在生产环境避免干扰。
警告的基本发出方式
用 warnings.warn() 可手动触发警告，需指定消息内容和警告类别（如 DeprecationWarning、UserWarning 等）：
import warnings
warnings.warn(“该函数将在下个版本移除”, DeprecationWarning)
默认情况下，DeprecationWarning 在交互式环境中不显示，但在模块导入时可能被抑制；而 UserWarning 通常会直接打印到控制台。选择合适类别有助于分类管理。
立即学习“Python免费学习笔记（深入）”；
临时忽略特定警告
在局部代码块中屏蔽警告，推荐用上下文管理器 with warnings.catch_warnings(): 配合 warnings.filterwarnings() 或 warnings.simplefilter()：
-
warnings.simplefilter("ignore", UserWarning)：忽略所有UserWarning -
warnings.filterwarnings("ignore", category=FutureWarning, module="mymodule")：只忽略指定模块中的FutureWarning - 加
action="once"可确保同类警告仅提示一次
这种写法不影响全局警告设置，适合测试或兼容旧逻辑的场景。
全局配置警告行为
通过命令行参数或运行时调用 warnings.filterwarnings() 控制整体策略：
- 启动 Python 时加
-W ignore::DeprecationWarning，可全局屏蔽某类警告 - 在脚本开头写
warnings.filterwarnings("Error", category=RuntimeWarning)，把特定警告转为异常，便于调试 - 设
"always"强制每次出现都提示，适合 CI/CD 中检查代码质量
注意：警告过滤规则按注册顺序匹配，靠后的规则可能被前面的覆盖，建议统一在程序入口处集中配置。
捕获并处理警告信息
若需分析警告内容（如日志记录、统计告警次数），可用 warnings.catch_warnings(record=True) 获取警告对象列表：
import warnings
with warnings.catch_warnings(record=True) as w:
warnings.warn(“测试警告”, UserWarning)
if w:
print(f”捕获到 {len(w)} 条警告，第一条：{w[0].message}”)
每个 w[0] 是 WarningMessage 实例，含 message、category、filename、lineno 等属性，可用于精准定位问题源头。