🌟 一、最常用魔法方法（90% 场景必备）#

💡 为什么常用？
这些方法覆盖了 90% 的日常开发需求：初始化对象、打印调试、操作容器、实现函数调用、比较逻辑、集合存储等。建议所有类都至少实现 __init__、__repr__ 和 __str__。

⚙️ 二、进阶魔法方法（高频场景）#

💡 典型使用场景

• __getattr__：实现动态属性（如 ORM 框架）
• __contains__：自定义集合类（如 if user in users）
• __add__：实现自定义数学运算（如向量、矩阵）

🔢 三、算术与位运算魔法方法#

💡 重要提示

• 二元操作符（如 __add__）优先级高于反向操作符（__radd__）
• 反向操作符（如 __radd__）在左侧操作数不支持时调用（例如 1 + obj）

📦 四、容器与迭代魔法方法#

💡 关键设计原则
实现 __iter__ 时，必须同时实现 __next__（或使用生成器）。
自定义容器类（如 MyList）必须实现 __len__ 和 __getitem__ 才能支持索引。

🛠️ 五、其他重要魔法方法#

💡 特别说明

• __new__ 是类方法（第一个参数是 cls），用于控制实例创建过程（如单例模式）。
• __del__ 不推荐使用：Python 垃圾回收机制不确定，可能导致资源泄漏。

❌ 六、不推荐使用的魔法方法#

📚 七、使用建议与最佳实践#

1. 优先实现 __init__ 和 __repr__

   1
   class User:
   2
       def __init__(self, name, age):
   3
           self.name = name
   4
           self.age = age
   5
   
   6
       def __repr__(self):
   7
           return f"User(name={self.name}, age={self.age})"
   

2. 避免过度重载
   仅当需要自定义行为时才实现魔法方法（例如，不实现 __add__ 除非需要 + 逻辑）。

3. 容器类必须实现 __len__ 和 __getitem__
   使类兼容 for 循环、len() 等内置操作。

4. 上下文管理器是 with 的核心

   1
   class Database:
   2
       def __enter__(self):
   3
           self.conn = connect()
   4
           return self.conn
   5
   
   6
       def __exit__(self, exc_type, exc_val, exc_tb):
   7
           self.conn.close()
   

5. 哈希与相等性需配合使用

   1
   def __eq__(self, other):
   2
       return self.id == other.id
   3
   
   4
   def __hash__(self):
   5
       return hash(self.id)  # 必须与 __eq__ 一致
   

手册总结

• 90% 场景：__init__, __repr__, __str__, __call__, __eq__, __len__, __getitem__, __iter__
• 高频场景：__getattr__, __contains__, __add__, __enter__/__exit__
• 特殊场景：__new__（元类）、__index__（切片）
• 避坑：不要用 __del__，确保 __hash__ 与 __eq__ 一致

💡 附：Python 官方文档 - 特殊方法