5.5 魔法方法（魔术方法）体系：对象行为的底层控制机制

在 Python 中，你创建的每一个类，都可以通过定义一些名字以双下划线开头和结尾的特殊方法（即“魔法方法”或“魔术方法”），来控制其实例的行为。这些方法通常不需要你直接调用，而是由 Python 解释器在特定语法或操作下自动触发。它们是 Python 对象模型的核心，让你能够用自然的语法写出功能强大的自定义类。

为什么叫“魔法方法”？

因为很多操作看起来像语言内置的“魔法”：比如你可以用 len(obj) 获取对象长度，背后其实是自动调用了 obj.len()；你可以用 obj[key] 访问元素，背后是 obj.getitem(key)。掌握魔法方法，意味着你不仅可以“使用”对象，还能“塑造”对象，让自定义类的行为与内置类型完全一致。

常用魔法方法分类与实用示例

1. 对象创建与销毁

init(self, ...)：初始化方法，在实例创建后自动调用，用于设置初始状态。这是最常见的魔法方法。
new(cls, ...)：真正的构造方法，负责创建并返回实例。一般只有在继承不可变类型（如 str、int）或实现单例模式时才需要重写。
del(self)：析构方法，在对象被垃圾回收前调用。通常不推荐依赖它做资源清理，应优先使用上下文管理器。

class MyClass:
    def __init__(self, value):
        self.value = value
        print("初始化完成")

2. 字符串表示

repr(self)：返回对象的“官方”字符串表示，应尽可能准确且无歧义，主要用于调试和开发。理想情况下 eval(repr(obj)) 应能重建该对象。
str(self)：返回对象的“非正式”字符串表示，用于 print() 和 str()。如果未定义 str，会回退到 repr。

class Point:
    def __init__(self, x, y):
        self.x, self.y = x, y
    def __repr__(self):
        return f"Point({self.x}, {self.y})"
    def __str__(self):
        return f"({self.x}, {self.y})"

3. 运算符重载

通过魔法方法，你可以让自定义对象支持 +、-、* 等运算符，像操作内置数值一样。

算术运算：add（+）、sub（-）、mul（*）、truediv（/）等。
比较运算：eq（==）、lt（<）、gt（>）等。

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 __eq__(self, other):
        return self.x == other.x and self.y == other.y

4. 容器模拟

让你的类表现得像列表、字典或集合。

len(self)：支持 len(obj)。
getitem(self, key)：支持索引访问 obj[key] 和迭代 for x in obj。
setitem(self, key, value)：支持赋值 obj[key] = value。
delitem(self, key)：支持 del obj[key]。
contains(self, item)：支持 in 成员测试。

class PlayList:
    def __init__(self, songs):
        self.songs = songs
    def __getitem__(self, index):
        return self.songs[index]
    def __len__(self):
        return len(self.songs)
    def __contains__(self, song):
        return song in self.songs

5. 属性访问控制

getattr(self, name)：当常规属性查找失败时被调用。
getattribute(self, name)：每次访问属性时都会无条件调用（注意避免无限递归）。
setattr(self, name, value)：设置属性时调用。
delattr(self, name)：删除属性时调用。

这些方法可用于实现代理模式、延迟加载或属性值校验。

6. 可调用对象与上下文管理

call(self, ...)：让实例可以像函数一样被调用。常用于实现装饰器类或函数式风格接口。
enter / exit：支持 with 语句，用于资源管理（如文件、锁）。

class Greeter:
    def __init__(self, name):
        self.name = name
    def __call__(self):
        return f"Hello, {self.name}!"

class ManagedFile:
    def __init__(self, filename):
        self.filename = filename
    def __enter__(self):
        self.file = open(self.filename, 'r')
        return self.file
    def __exit__(self, exc_type, exc_val, exc_tb):
        self.file.close()

实际应用中的最佳实践

不要过度使用：魔法方法让语法优雅，但滥用会令代码变得隐晦。只在自定义数据类型有明显语义时使用运算符重载。
遵守约定：例如 repr 应该返回对开发者友好的表达式，eq 定义了最好也定义 hash 或者把它设为 None（当对象可变时）。
注意性能：频繁触发的魔法方法（如 getattr、setattr）要写得轻量，避免在内部做耗时操作。

魔法方法是 Python 对象模型灵活性的基石。掌握它们，你就掌握了定制类行为的钥匙，可以写出与 Python 内置类型无缝整合、简洁且强大的代码。