魔术方法（Magic Methods）以__开头和结尾，是 Python 实现面向对象特性的核心机制。它们由解释器自动调用，无需手动触发，用于赋予对象特殊行为（如运算符重载、容器模拟、上下文管理等）。

一、构造与初始化相关

示例：

python

运行

class Singleton:
    _instance = None
    def __new__(cls):
        if cls._instance is None:
            cls._instance = super().__new__(cls)
        return cls._instance
    
    def __init__(self):
        self.value = 0

s1 = Singleton()
s2 = Singleton()
print(s1 is s2)  # True（单例模式）

二、字符串表明相关

示例：

python

运行

class Person:
    def __init__(self, name, age):
        self.name = name
        self.age = age
    
    def __str__(self):
        return f"Person({self.name}, {self.age})"  # 用户友善
    
    def __repr__(self):
        return f"Person(name='{self.name}', age={self.age})"  # 可还原对象

p = Person("Alice", 25)
print(p)          # Person(Alice, 25)（__str__）
print(repr(p))    # Person(name='Alice', age=25)（__repr__）

三、运算符重载相关

1. 算术运算符

2. 比较运算符

示例：

python

运行

class Vector:
    def __init__(self, x, y):
        self.x = x
        self.y = 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

v1 = Vector(1, 2)
v2 = Vector(3, 4)
print(v1 + v2)   # <__main__.Vector object at 0x...>（需配合__str__）
print(v1 == Vector(1,2))  # True

四、容器类型模拟

用于让自定义对象像列表、字典等容器一样工作。

示例：

python

运行

class CustomList:
    def __init__(self):
        self.data = []
    
    def __len__(self):
        return len(self.data)
    
    def __getitem__(self, idx):
        return self.data[idx]
    
    def __setitem__(self, idx, value):
        self.data[idx] = value
    
    def __contains__(self, item):
        return item in self.data

cl = CustomList()
cl.data = [1,2,3]
print(len(cl))    # 3
print(cl[0])      # 1
cl[0] = 10
print(2 in cl)    # True

五、可调用对象模拟

示例：

python

运行

class Counter:
    def __init__(self):
        self.count = 0
    
    def __call__(self):
        self.count += 1
        return self.count

c = Counter()
print(c())  # 1
print(c())  # 2（调用实例时更新状态）

六、上下文管理器（with 语句）

示例：

python

运行

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

with FileHandler("test.txt", "w") as f:
    f.write("Hello")  # 自动打开/关闭文件

七、属性访问控制

用于自定义属性的获取、设置、删除逻辑。

示例：

python

运行

class SafeDict:
    def __init__(self):
        self._data = {}
    
    def __getattr__(self, name):
        return self._data.get(name, f"属性{name}不存在")
    
    def __setattr__(self, name, value):
        if name.startswith("_"):
            super().__setattr__(name, value)  # 避免递归
        else:
            self._data[name] = value

sd = SafeDict()
sd.name = "Alice"
print(sd.name)    # Alice
print(sd.age)     # 属性age不存在

八、迭代器相关

用于让对象支持迭代（如for…in循环）。

示例：

python

运行

class MyRange:
    def __init__(self, start, end):
        self.start = start
        self.end = end
    
    def __iter__(self):
        return self  # 返回自身作为迭代器
    
    def __next__(self):
        if self.start >= self.end:
            raise StopIteration
        current = self.start
        self.start += 1
        return current

for i in MyRange(1, 4):
    print(i)  # 1 2 3

九、其他常用魔术方法

示例：

python

运行

class Point:
    def __init__(self, x, y):
        self.x = x
        self.y = y
    
    def __hash__(self):
        return hash((self.x, self.y))  # 基于坐标生成哈希值
    
    def __bool__(self):
        return self.x != 0 or self.y != 0  # 坐标全0时为False

p1 = Point(1, 2)
p2 = Point(0, 0)
print(hash(p1))  # 哈希值
print(bool(p1))  # True
print(bool(p2))  # False

总结

魔术方法是 Python 面向对象的 “黑魔法”，通过实现这些方法，能让自定义对象拥有 Python 内置类型的行为特性。核心要点：

1. 魔术方法由解释器自动调用，无需手动调用；
2. 不同魔术方法对应不同的场景（如运算符、容器、上下文管理）；
3. 合理使用魔术方法可大幅提升代码的简洁性和可读性，让自定义类更 “Pythonic”。