Python双下划线开头的具体使用

Python中以双下划线开头的方法和属性（如 __init__）称为特殊方法或魔法方法（magic methods），它们的命名和使用遵循严格的约定。以下是详细分类和具体用法：

一、核心用途分类

1. 对象生命周期控制

class MyClass:
    def __init__(self, value):      # 构造器
        self.value = value

    def __del__(self):              # 析构器（谨慎使用）
        print("对象被销毁")

obj = MyClass(10)  # 触发 __init__
del obj           # 触发 __del__

2. 运算符重载

class Vector:
    def __init__(self, x, y):
        self.x, self.y = x, y

    def __add__(self, other):        # 重载 + 运算符
        return Vector(self.x + other.x, self.y + other.y)

    def __str__(self):              # 重载 print()
        return f"Vector({self.x}, {self.y})"

v1 = Vector(1, 2)
v2 = Vector(3, 4)
print(v1 + v2)  # Vector(4, 6)

3. 容器类型模拟

class Stack:
    def __init__(self):
        self._items = []

    def __len__(self):              # 重载 len()
        return len(self._items)

    def __getitem__(self, index):   # 重载 []
        return self._items[index]

    def __setitem__(self, index, value):  # 支持 s[0]=x
        self._items[index] = value

s = Stack()
s._items = [1, 2, 3]
print(len(s))    # 3
print(s[1])      # 2

4. 属性访问控制

class Secret:
    def __init__(self):
        self.public = "公开"
        self._protected = "受保护"
        self.__private = "私有"      # 名称修饰（name mangling）

    def __getattr__(self, name):    # 访问不存在的属性时触发
        return f"{name} 不存在"

s = Secret()
print(s.public)           # "公开"
print(s._protected)       # "受保护"
print(s._Secret__private) # "私有"（实际被重命名为 _Secret__private）
print(s.abc)              # "abc 不存在"（触发 __getattr__）

二、常见魔法方法速查表

三、重要细节

1. 名称修饰（Name Mangling）

class Test:
    def __init__(self):
        self.__secret = 10     # 实际变为 _Test__secret

t = Test()
print(t._Test__secret)  # 可以访问
print(t.__secret)       # AttributeError

2. 避免无限递归

class Demo:
    def __init__(self):
        self.__dict__['x'] = 1  # 绕过 __setattr__

    def __setattr__(self, name, value):
        # 错误：self.name = value 会再次调用 __setattr__ 导致递归
        # 正确：
        self.__dict__[name] = value

3. 上下文管理器示例

class FileManager:
    def __init__(self, filename):
        self.filename = filename

    def __enter__(self):
        self.file = open(self.filename, 'w')
        return self.file

    def __exit__(self, exc_type, exc_val, exc_tb):
        self.file.close()

with FileManager("test.txt") as f:
    f.write("Hello")

四、使用建议

五、示例：完整类设计

class Rational:
    """有理数类示例"""
    def __init__(self, numerator, denominator=1):
        self.n = numerator
        self.d = denominator

    def __add__(self, other):
        # 简化版加法
        return Rational(self.n + other.n, self.d)

    def __str__(self):
        return f"{self.n}/{self.d}"

    def __repr__(self):
        return f"Rational({self.n}, {self.d})"

    def __float__(self):
        return self.n / self.d

r1 = Rational(1, 2)
r2 = Rational(3, 2)
print(r1 + r2)    # 4/2
print(float(r1))  # 0.5

记住：双下划线方法让Python对象能够集成到语言基础设施中，正确使用它们可以创建出行为类似内置类型的优雅对象。