为Python库创建自定义警告：继承Warning还是UserWarning？

在Python的警告体系里，优先继承UserWarning是通用惯例，原因如下：

• UserWarning是官方明确预留的、供用户（包括库开发者）扩展的标准警告子类，属于Warning的派生分支，完全契合自定义业务警告的设计意图。
• 直接继承Warning会让你的自定义警告和系统级警告（如DeprecationWarning、SyntaxWarning）处于同一基类层级，用户在过滤警告时容易混淆——多数用户会用-W default::UserWarning这类规则来管理自定义警告，而直接继承Warning的类可能会被纳入更宽泛的过滤范围，不符合预期。

你提到想把UserWarning留作warnings.warn()的默认情况，其实这不冲突：warnings.warn()的默认确实是UserWarning，但你完全可以基于它派生自己的库专属警告类，示例代码：

class MyLibraryRiskWarning(UserWarning):
    pass

# 在需要的场景抛出自定义警告
warnings.warn("该操作存在潜在风险，请确认参数配置", MyLibraryRiskWarning)

额外提醒：如果你的警告属于特定类型（比如接口弃用），应该继承对应的专用警告类（如DeprecationWarning）；但对于通用的潜在风险提示，UserWarning是标准且合规的选择。

内容的提问来源于stack exchange，提问作者shadowtalker