什么时候使用 python sunder 名称？

Question

在 Python 中，有单前导下划线、双前导下划线、双前导 + 双尾下划线和单尾下划线的约定。其中许多都在 What is the meaning of a single- and a double-underscore before an object name? 的答案中进行了概述。

但是单前导+单尾下划线的含义或约定是什么？我第一次看到他们在enum module：

8.13.15.3.2。支持_sunder_ 名称

• _name_ – 成员姓名
• _value_ – 成员的值；可以在new中设置/修改
• _missing_ – 找不到值时使用的查找函数；可能会被覆盖
• _ignore_ – 名称列表，可以是 list() 或 str()，不会转换为成员，并将从最终类中删除
• _order_ – 在 Python 2/3 代码中使用以确保成员顺序一致（类属性，在类创建期间删除）
• _generate_next_value_ – 由功能 API 和自动使用来为枚举成员获取适当的值；可能会被覆盖

我以前从未见过这样的单前导单尾下划线 sunder 名称。它们是否以任何特殊方式处理，或者以其他方式具有与任何其他与下划线相关的命名约定不同的隐含含义？它们与根本没有下划线有何不同？

Answer 1

他们没有受到任何特殊对待。它们被 enum 模块用来

• 不会被意外覆盖

例如

class Status(Enum):
    alive = auto()
    dead = auto()
    missing = auto()

您可以看到Status.missing 和Status._missing_ 是不同的对象。如果 Enum 方法 _missing_ 被命名为 missing，我们会覆盖它。

• 不显示为私有。 python 中的名称_value 被认为是私有的。为了表示这些不是私有的（同样，用户可能希望枚举值是私有的），而是给它们命名

• 其他替代品，如__double_leading_underscore 和__dunder__ 在python 中也有特殊含义，如上所述。 Enum 中的 _sunder_ 方法类似于纯 python 的 __dunder__ 协议，但不被语言保留。

基本上，这是一种避免属性名称冲突而又不给人错误印象的选项。