Python中的魔法方法指的是以双下划线开头和结尾的特殊方法，官方名称为dunder method，这类方法不需要开发者主动调用，而是在特定场景下由Python解释器自动触发执行，是Python实现很多内置功能的核心机制。
魔法方法的基本使用场景
最常见的魔法方法是__init__，用于对象初始化，在创建类的实例时自动执行。除此之外还有很多常用的魔法方法，下面通过示例说明。
基础魔法方法示例
先看一个包含多个常用魔法方法的自定义类示例：
class Student:
def __init__(self, name, score):
# 初始化实例属性
self.name = name
self.score = score
def __str__(self):
# 打印对象时返回可读性强的字符串
return f"学生姓名：{self.name}，成绩：{self.score}"
def __add__(self, other):
# 重载+运算符，计算两个学生的成绩总和
if isinstance(other, Student):
return self.score + other.score
return NotImplemented
def __len__(self):
# 重载len()函数，返回成绩数值的长度
return len(str(self.score))
# 创建实例
stu1 = Student("张三", 90)
stu2 = Student("李四", 85)
# 触发__str__方法
print(stu1)
# 触发__add__方法
print(stu1 + stu2)
# 触发__len__方法
print(len(stu1))
运行上述代码会依次输出：
学生姓名：张三，成绩：90
175
2
可以看到我们并没有主动调用__str__、__add__、__len__这些方法，但是对应的操作触发了它们的执行。
dunder方法的设计原理
Python的dunder方法设计核心是为了实现运算符重载和内建函数适配，让自定义类的实例可以像内置类型一样使用各种语法和函数。
统一接口设计
Python内置的很多操作都有对应的魔法方法作为统一接口，比如加法操作对应__add__，打印对应__str__和__repr__，索引操作对应__getitem__。这样不管是内置类型还是自定义类型，只要实现了对应的魔法方法，就可以支持相同的操作，保证了语法的一致性。
解释器自动触发机制
当执行a + b这样的操作时，解释器首先会检查a是否有__add__方法，如果有就调用a的__add__(b)，如果返回NotImplemented，再检查b是否有__radd__方法。这种机制让运算符的处理逻辑可以分散到参与运算的各个对象中，不需要额外的全局判断逻辑。
特殊方法的分层设计
Python的魔法方法分为多个层级，比如对象的基础生命周期相关的是__new__和__init__，运算相关的是各类算术、比较魔法方法，属性访问相关的是__getattr__、__setattr__等。不同类型的魔法方法各司其职，开发者可以根据需求选择实现对应的方法，不需要全部重写。
自定义类中魔法方法的设计建议
在设计自定义类的魔法方法时，需要遵循几个原则：
- 魔法方法的行为要符合用户的预期，比如
__add__实现的是合理的加法逻辑，不要在其中做无关的操作 - 实现双向运算魔法方法时，比如
__add__对应的__radd__也要考虑实现，避免运算顺序导致报错 - 不需要过度实现魔法方法，只实现当前类需要支持的功能对应的方法即可，多余的魔法方法会增加代码复杂度
常见魔法方法对照表
下面是常用的魔法方法及其触发场景对照：
| 魔法方法 | 触发场景 |
|---|---|
| __init__ | 创建实例时执行 |
| __str__ | print打印对象、str()转换时执行 |
| __repr__ | 交互式环境输出对象、repr()转换时执行 |
| __add__ | 对象参与+运算时执行 |
| __getitem__ | 对象使用[]索引取值时执行 |
| __len__ | 调用len()函数时执行 |
理解魔法方法的使用方式和设计原理，能够帮助我们更好地编写符合Python风格的代码，让自定义类的使用体验更接近内置类型，提升代码的可读性和可维护性。