Skip to content

魔术方法(Magic Method)

一句话解释

魔术方法是 __dunder__ 方法,让你的对象与 Python 运算符(+、len()、str() 等)配合工作。

用大白话说

魔术方法(因其双下划线名称也称为 dunder 方法)让你定义自定义对象如何与 Python 的内置操作和运算符交互。常见的:

  • __init__——构造函数
  • __str__ / __repr__——字符串表示
  • __eq__、__lt__——比较
  • __add__、__mul__——算术运算符
  • __len__、__getitem__——容器协议
  • __enter__ / __exit__——上下文管理器
  • __iter__ / __next__——迭代你不会直接调用这些——Python 在你对对象使用运算符或内置函数时调用它们。

示例

python
class Vector:
    def __init__(self, x, y):
        self.x = x
        self.y = y
    
    def __repr__(self):
        return f"Vector({self.x}, {self.y})"
    
    def __add__(self, other):
        return Vector(self.x + other.x, self.y + other.y)
    
    def __abs__(self):
        return (self.x ** 2 + self.y ** 2) ** 0.5

v1 = Vector(3, 4)
v2 = Vector(1, 2)
print(v1 + v2)   # Vector(4, 6) — uses __add__
print(abs(v1))   # 5.0 — uses __abs__

魔术方法使自定义对象能与 +、abs()、print() 等配合工作。Python 隐式调用它们——你很少直接调用。

常见混淆

  • 容易混淆的对象: 普通方法

    关键区别: 魔术方法有 __dunder__ 名称,由 Python 运算符/内置函数隐式调用(v1 + v2 调用 __add__)。普通方法按名称显式调用(obj.method())。你永远不应直接调用魔术方法。

相关术语

相关资源

相关课程

解读错误信息

用大白话解释常见错误——什么意思、为什么发生、如何修复。

查看错误

← 返回术语表