魔术方法用于定义对象在特定操作下的行为，应仅在语义清晰、符合直觉时重载；运算符需有明确数学或领域含义；实现__eq__通常需配套__hash__，比较方法应保持一致性。
魔术方法（Magic Methods）是 Python 中以双下划线开头和结尾的特殊方法，如 __init__、__str__、__add__ 等。它们不是“炫技工具”，而是用于定义对象在特定语言操作下的行为。合理使用的关键在于：只在语义清晰、接口自然、符合直觉时才重载；避免为小众需求或内部逻辑强行挂钩。
仅当操作有明确数学或领域语义时重载运算符
比如自定义向量类支持 + 或 * 是合理的，因为加法、标量乘法在数学中有明确定义；但让字符串类支持 &（位与）就违背直觉。Python 的设计哲学强调“显式优于隐式”，运算符重载必须让用户一眼看懂它在做什么。
- ✅ 推荐：
Money.__add__(other)表示金额相加，DateTime.__sub__(other)返回时间差 - ❌ 避免：
User.__mul__(n)表示“复制用户”或“生成 n 个测试账户”——这不是乘法的常规含义，应改用普通方法如user.duplicate(n)
保持一致性与对称性
如果实现了 __eq__，通常也应实现 __hash__（除非实例可变）；若重载了 __lt__，最好同时提供 functools.total_ordering 或补全其他比较方法。不一致的行为会破坏内置函数（如 sorted()、set()）的预期表现。
- 若
a == b为真，hash(a) == hash(b)应为真（否则无法安全放入字典或集合） - 若
a 和 <code>b 为真，则 <code>a 也应为真（传递性），否则 <code>sorted([a,b,c])可能出错或结果不可靠
避免在魔术方法中引入副作用或复杂逻辑
__str__ 应快速返回可读字符串，不该触发网络请求或修改状态；__init__ 负责初始化，不该承担验证失败后的日志上报或资源清理任务。魔术方法被 Python 解释器频繁调用（例如打印、循环、比较），性能和纯度直接影响整体稳定性。
立即学习“Python免费学习笔记（深入）”；
- ❌ 不要这样写：
def __str__(self): log_access(self); return f"User({self.name})" - ✅ 正确做法：把日志、缓存、IO 等逻辑移出魔术方法，放在专用方法或属性中
优先用协议而非单个魔术方法
Python 更鼓励实现完整协议（Protocol），而不是零散重载几个魔术方法。例如想让对象支持 for 循环，应实现 __iter__（返回迭代器），而非试图重载 __getitem__ 模拟序列——后者容易漏掉边界处理（如 IndexError），且不支持 iter() 的高级用法。
- 支持上下文管理？实现
__enter__和__exit__，而不是在__del__中关文件（__del__调用时机不确定） - 支持异步迭代？实现
__aiter__和__anext__，而非在__iter__中返回协程对象
不复杂但容易忽略：魔术方法是桥梁，不是后门。它的价值在于让自定义类型无缝融入 Python 生态，而不是拓展语法本身。用得克制，才能让人读懂；用得精准，才能让代码健壮。
