Python魔法方法是以双下划线开头结尾的特殊方法，由解释器在特定操作时自动调用，用于定制类行为，使自定义对象支持如+、==、len()等内置操作，并融入Python协议生态。
Python魔法方法（Magic Methods），也叫特殊方法（Special Methods），是类中以双下划线开头和结尾的方法，比如 __init__、__str__、__add__。它们不是让你手动调用的，而是由Python解释器在特定操作发生时自动触发，用来定制类的行为。
魔法方法让对象像内置类型一样工作
Python内置类型（如 int、list、str）支持 +、==、print()、len() 等操作，是因为它们内部实现了对应的魔法方法。你给自己的类加上这些方法，就能让实例支持相同语法：
-
__add__(self, other) → 支持
a + b -
__eq__(self, other) → 支持
a == b -
__len__(self) → 支持
len(a) -
__getitem__(self, key) → 支持
a[key]（像列表或字典那样索引）
最常用且必须了解的几个魔法方法
有些魔法方法几乎每个自定义类都可能用到，掌握它们能写出更自然、更Pythonic的代码：
- __init__(self, ...)：构造方法，创建对象时自动运行（注意它不返回值，只负责初始化）
-
__str__(self)：返回用户友好的字符串表示，用于
print()和str() -
__repr__(self)：返回开发者友好的“可复现”字符串，用于调试和交互式环境（推荐格式：
ClassName(...)） -
__bool__(self)：决定
if obj:中对象被视为 True 还是 False（没定义时默认为 True）
魔法方法不是语法糖，而是协议的一部分
Python通过“协议”（Protocol）来实现多态——只要一个类实现了 __iter__ 和 __next__，它就是迭代器；只要实现了 __enter__ 和 __exit__，就能用于 with 语句。这不是强制继承，而是约定俗成的接口。写对魔法方法，你的类就天然融入Python生态。
Claw Code Suite (Python-Only Edition)
下载
仅使用 Python 将 Claw Code 虚拟化框架与 OpenClaw 集成，提供 184 种工具和 200 多条命令，用于安全分析和代码质量...
立即学习“Python免费学习笔记（深入）”；
注意命名和使用规范
魔法方法名不能随意改动（比如写成 _init_ 就无效），且多数不应直接调用（如不用 obj.__str__()，而用 str(obj) 或 print(obj)）。Python会根据上下文自动选择并调用合适的方法，包括一些有回退逻辑的（例如没有 __bool__ 时会尝试 __len__）。
不复杂但容易忽略。写类时多想一句：“我这个对象，别人会怎么用它？”——那句“怎么用”，往往就对应着一个魔法方法。
