17370845950

Python下划线命名有三类语义：单下划线_表内部使用提示，无解释器干预；双下划线__触发类内名称修饰（_ClassName__attr）；双下划线开头结尾__xxx__为特殊方法，实现协议操作。

Python 中的下划线命名不是随意约定，而是有明确语义和解释器行为支撑的规范。理解它们的区别，能帮你写出更符合 Python 习惯、更易维护、也更少触发意外行为的代码。

单下划线 _：仅供内部使用的提示

它本身不触发任何语言机制，纯粹是给开发者看的“软信号”。Python 解释器完全忽略它——不会限制访问，不会重命名，也不会影响导入。

常见用法包括：

• 临时变量（如循环中不用的索引）：for _ in range(5): print("hello")
• 模块中不想被 from module import * 导入的名称：_helper = "internal"
• 表示某个变量“这里用完就丢”，比如解包时忽略某项：name, _, age = ("Alice", "Ms.", 30)

注意：import * 不导入以 _ 开头的名称，但直接 import module 后仍可访问 module._helper。

双下划线 __：类内名称修饰（Name Mangling）

这是 Python 解释器主动介入的行为，只在类定义中生效。形如 __attr 或 __method() 的名称，会被自动重写为 _ClassName__attr，目的是避免子类意外覆盖父类的“私有”实现。

例如：

class A:
    def __init__(self):
        self.__x = 10
class B(A):
def init(self):
super().init()
self.x = 20  # 实际生成的是 _B__x，与 _Ax 不冲突

此时 A().__x 会报 AttributeError，但 A()._A__x 可以访问。这并非真正私有，只是加了一层“防手误”的屏障。

关键点：

• 仅对类体中以 __ 开头且不以 __ 结尾的标识符生效
• 不作用于全局变量、函数名或模块级变量
• 如果名字以 __ 开头又以 __ 结尾（如 __init__），则不触发修饰

双下划线开头+双下划线结尾 __xxx__：特殊方法（Dunder Methods）

这类名称被称为“dunder”（double underscore），是 Python 的语法钩子，对应特定语言操作。解释器在执行某些动作时，会自动查找并调用它们。

例如：

• obj + other → 触发 obj.__add__(other)
• len(obj) → 触发 obj.__len__()
• print(obj) → 触发 obj.__str__()（或 __repr__()）
• with obj: → 触发 obj.__enter__() 和 obj.__exit__()

你可以在自定义类中实现这些方法，让实例支持内置操作。但请不要为自己的变量或方法随意使用这种命名**——除非你真正在实现

额外提醒：__all__ 和单下划线模块名

__all__ 是一个特殊的列表，用于显式声明模块通过 from module import * 允许导出的名称，优先级高于下划线规则。例如：

__all__ = ["PublicClass", "public_function"]
_private_helper = "not exported"

即使 _private_helper 没有下划线，只要不在 __all__ 中，就不会被 import * 导入；反之，哪怕名字是 _helper，只要列在 __all__ 里，也会被导入。

另外，以 _ 开头的模块文件（如 _utils.py）不是语法要求，而是社区惯例，表示“该模块不建议直接导入”，工具链（如 IDE、linter）可能据此给出提示，但 Python 解释器本身不作限制。