Python 中的魔术方法

在 Python 中，魔术方法（Magic Methods），也被称为特殊方法（Special Methods）或 dunder 方法（Double Underscore Methods），是指那些名称以双下划线（__）开头和结尾的方法（如 __init__、__str__）。

魔术方法的核心特征在于它们的“魔术”之处：你通常不需要手动调用它们，而是由 Python 解释器在特定场景下自动触发执行。通过实现这些方法，开发者可以自定义类的构造、打印、运算、长度、迭代等行为，使自定义对象能够像 Python 内置类型一样自然地融入语言的操作体系中。

核心特点与最佳实践

• 自动触发：在创建对象、打印对象、进行运算、切片或生命周期管理时自动执行。
• 规范调用：在实际开发中，应尽量避免直接调用魔术方法（例如写 len(obj) 而不是 obj.__len__()），因为内置函数调用包含了安全检查和回退机制。
• 协议基础：魔术方法是 Python “鸭子类型”和协议（Protocol）的基础。只要你的类实现了特定的魔术方法，它就具备了相应的能力（例如实现了 __iter__ 就可以被 for 循环遍历），而无需继承特定的基类。

常用的魔术方法分类

1. 对象生命周期管理

• __init__(self, ...)：构造方法，在创建对象时自动调用，用于初始化对象的属性。
• __new__(cls, ...)：创建实例的第一个方法，在 __init__ 之前执行，用于控制实例的创建过程。
• __del__(self)：析构方法，在对象被销毁或程序结束时自动调用，常用于释放资源。

2. 字符串表示

• __str__(self)：定义对象被 print() 函数打印时的字符串表示，偏向于面向终端用户的可读格式。
• __repr__(self)：定义对象的“官方”字符串表示，偏向于开发者调试，通常在交互式命令行或容器内打印对象时触发。

3. 容器行为模拟

• __len__(self)：让自定义对象支持 len() 函数以获取长度。
• __getitem__(self, index)：让自定义对象支持通过下标或切片（如 obj[key]）获取元素。
• __setitem__(self, index, value)：支持通过下标赋值（如 obj[key] = value）修改数据。

4. 运算符重载

• __add__(self, other)：定义 + 运算符的行为，允许自定义对象之间进行加法运算。

5. 迭代与上下文管理

• __iter__(self) 和 __next__(self)：让自定义类支持 for 循环遍历。
• __enter__(self) 和 __exit__(self)：让自定义类支持 with 语句，实现资源的自动管理（如自动关闭文件）。

6. 对象调用

• __call__(self, ...)：使得一个对象可以像函数一样被调用（即在对象后加括号并传递参数）。