warnings.warn()发出的弃用警告默认不显示，因Python静默过滤DeprecationWarning；需用-W default或warnings.simplefilter("default", DeprecationWarning)启用，stacklevel=2可准确定位调用方，测试中用warnings.catch_warnings(record=True)配合simplefilter("always")捕获验证。
为什么 warnings.warn() 发出的弃用警告默认不显示
Python 默认只对 DeprecationWarning 和 PendingDeprecationWarning 做“静默过滤”——它们不会打印到控制台，哪怕你写了 warnings.warn("xxx", DeprecationWarning)。这是设计使然：避免干扰终端用户，但对开发者是“隐形陷阱”。实际调试时，你得主动打开开关才能看见。
常见错误现象：函数里加了弃用提示，运行却完全没输出；CI 流程里也没报错，直到某天升级 Python 版本后突然崩掉。
- 临时启用：启动 Python 时加
-W default（例如python -W default script.py） - 代码内启用：在入口处加
warnings.simplefilter("default", DeprecationWarning) - 注意：不要用
"always"，它会在每次调用都触发，容易淹没日志；"default"是平衡点——首次出现时提醒，后续同位置不再重复
如何让自定义弃用警告精准定位调用方
默认 warnings.warn() 显示的是警告发出位置（即封装函数内部），不是业务代码调用处。这对排查毫无帮助。
关键参数是 stacklevel：它决定往调用栈上数几层来定位文件/行号。对封装好的弃用工具函数，通常设为 2 才能指向真实调用者。
import warnings <p>def old_api(): warnings.warn( "old_api() is deprecated, use new_api() instead", DeprecationWarning, stacklevel=2 # ← 这里！不是 1 ) return "legacy result" </p>
- 如果函数嵌套更深（比如通过装饰器或中间件转发），可能需要
stacklevel=3或更高 - 别硬编码数字——可配合
inspect.currentframe()动态计算，但多数场景2足够 - Python 3.12+ 支持
warnings.warn_explicit()，能彻底控制 filename/lineno，但兼容性差，慎用
怎样在测试中捕获弃用警告并断言
单元测试里不能靠“肉眼观察输出”，必须程序化验证弃用逻辑是否生效。核心是 warnings.catch_warnings() 上下文管理器 + record=True。
import warnings
import pytest
<p>def test_old_api_warns():
with warnings.catch_warnings(record=True) as w:
warnings.simplefilter("always") # 必须设为 always，否则捕不到
result = old_api()
assert len(w) == 1
assert issubclass(w[0].category, DeprecationWarning)
assert "deprecated" in str(w[0].message)
</p>
- 漏掉
warnings.simplefilter("always")是最常见错误——默认过滤策略仍起作用，record=True也捕不到 - pytest 用户可直接用
@pytest.mark.filterwarnings("error::DeprecationWarning")把警告转成异常，更严格 - 注意：
catch_warnings()默认不继承外层过滤规则，所以必须显式设置simplefilter
生产环境要不要屏蔽弃用警告
要，但必须有节制。用户进程里看到 DeprecationWarning 不仅难看，还可能被日志系统误判为错误。
推荐做法是在应用启动时统一压制，而非全局关闭：
- 仅对终端用户脚本：启动时加
-W ignore::DeprecationWarning - Web 应用（如 Flask/Django）：在
__main__.py或 WSGI 入口加warnings.filterwarnings("ignore", category=DeprecationWarning) - 绝对不要在库代码里调用
warnings.filterwarnings()——这会污染下游用户的警告策略 - 第三方包引发的弃用警告？用
pip install -U升级，或检查其 issue 是否已修复；长期依赖旧版只能自己加临时 filter
真正棘手的是跨版本兼容：Python 3.12 开始把部分内置行为的弃用警告升级为 FutureWarning，而 FutureWarning 默认是显示的。这意味着老代码在新解释器里突然“冒泡”，得提前用 -W error 在 CI 中兜底。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
