Python常用双下划线函数清单：__init__到__call__速查

在 Python 中，形如 __init__、__str__、__call__ 的双下划线方法通常被称为特殊方法（Special Methods）或“魔术方法”（Magic Methods）。它们并不是由开发者手动显式调用的普通函数，而是由 Python 解释器在执行特定操作语法（如对象实例化、加减运算、字符串打印、函数调用等）时隐式绑定的底层钩子。掌握这些特殊方法，是理解 Python 面向对象设计和数据模型协议的核心路径。

一、双下划线函数的核心运作机制

双下划线函数背后的核心思想是“统一协议驱动语法糖”。例如，当我们写下 obj() 时，解释器并非寻找一个普通的函数句柄，而是调用 obj.__call__()；当我们编写 a + b 时，解释器会映射为 a.__add__(b)。这种机制让开发者自定义的类能够与 Python 内建类型拥有一致的使用体验。

图1：Python 常用双下划线特殊方法分发与映射原理图

二、常用核心双下划线方法分类速查

三、从实例化到销毁：对象的创建流程详解

在 Python 类中，实例化一个对象并非单纯执行 __init__。实际上，实例的诞生是由 __new__ 和 __init__ 两个步骤协同完成的。__new__ 是一个静态方法（即使没有显式声明 @staticmethod），它负责在内存中创建并返回该类的实例；而 __init__ 则是接收这个已创建的实例作为 self，进行属性绑定的初始化。

图2：Python 对象实例化从内存分配到初始化的顺序步骤

下面是一个直观展示 __new__ 与 __init__ 协同工作的代码示例：

class Connection:
    def __new__(cls, host: str, port: int):
        print(f"[1] __new__ 被调用，为 {cls.__name__} 分配内存")
        instance = super().__new__(cls)
        return instance

    def __init__(self, host: str, port: int):
        print(f"[2] __init__ 被调用，初始化实例属性 host={host}, port={port}")
        self.host = host
        self.port = port

# 执行实例化
conn = Connection("127.0.0.1", 8080)

执行输出示例：

[1] __new__ 被调用，为 Connection 分配内存
[2] __init__ 被调用，初始化实例属性 host=127.0.0.1, port=8080

四、让实例像函数一样被调用：__call__ 的威力

在 Python 中，函数是头等对象（First-Class Object）。而通过定义 __call__ 方法，可以让任何普通类的实例具备“可调用”（Callable）的特性。使用内置的 callable(obj) 会返回 True。

与普通纯函数相比，实现了 __call__ 的类实例最大的优势在于能够在内部持久保留状态，同时对外暴露干净的函数式调用接口。这在统计计数、缓存机制、中间件拦截器和配置装载器中极为常用。

图3：闭包机制与 __call__ 实例状态管理的架构对比

下面通过一个具备记忆能力的累计执行器，演示 __call__ 的典型用法：

class RateAccumulator:
    def __init__(self, initial_rate: float = 1.0):
        self.rate = initial_rate
        self.call_history = []

    def __call__(self, value: float) -> float:
        """实例被当作函数执行时自动进入此处"""
        result = value * self.rate
        self.call_history.append((value, result))
        return result

    def reset(self):
        """实例依旧保留普通方法支持"""
        self.call_history.clear()

# 实例化对象
calc = RateAccumulator(1.08)

# 像函数一样直接调用对象
price1 = calc(100.0)
price2 = calc(250.0)

print("计算结果:", price1, price2)
print("调用历史记录:", calc.call_history)

示例输出：

计算结果: 108.0 270.0
调用历史记录: [(100.0, 108.0), (250.0, 270.0)]

五、构建完整对象：双下划线方法决策总结

在设计一个生产可用的 Python 类时，开发者应当根据类所承担的职责，有选择地接入对应的双下划线协议，而不是一次性实现所有方法。下述决策路径为日常开发提供了清晰的判断依据：

图4：Python 常见双下划线函数按需选用与设计决策总结图

六、编写双下划线函数的避坑指南

通过合理接入从 __init__ 到 __call__ 的各个双下划线函数，能够让自定义类型与 Python 的原生语法环境无缝融合，不仅让代码更加优雅紧凑，也为构建健壮、易维护的模块提供了标准支持。