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。
立即学习“Python免费学习笔记（深入）”；
双下划线 __：类内名称修饰（Name Mangling）
这是 Python 解释器主动介入的行为，只在类定义中生效。形如 __attr 或 __method() 的名称，会被自动重写为 _ClassName__attr，目的是避免子类意外覆盖父类的“私有”实现。
例如：
class A:
def __init__(self):
self.__x = 10
<p>class B(A):
def <strong>init</strong>(self):
super().<strong>init</strong>()
self.<strong>x = 20 # 实际生成的是 _B__x，与 _A</strong>x 不冲突</p>此时 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__()
你可以在自定义类中实现这些方法，让实例支持内置操作。但请不要为自己的变量或方法随意使用这种命名**——除非你真正在实现协议（如迭代器需 __iter__ 和 __next__），否则容易和未来 Python 新增的特殊方法冲突。
额外提醒：__all__ 和单下划线模块名
__all__ 是一个特殊的列表，用于显式声明模块通过 from module import * 允许导出的名称，优先级高于下划线规则。例如：
__all__ = ["PublicClass", "public_function"] _private_helper = "not exported"
即使 _private_helper 没有下划线，只要不在 __all__ 中，就不会被 import * 导入；反之，哪怕名字是 _helper，只要列在 __all__ 里，也会被导入。
另外，以 _ 开头的模块文件（如 _utils.py）不是语法要求，而是社区惯例，表示“该模块不建议直接导入”，工具链（如 IDE、linter）可能据此给出提示，但 Python 解释器本身不作限制。
