python __new__ 方法报错 TypeError 的坑

起因

我想要制作一个单例类，在这类当中通过 new 的方法去规定这个类只能生成一个实例。

在尝试使用单例类制作的时候，我模仿了以前在网络上看到的一个关于类的教程，其中有提到单例类这个概念和实现方式，以下是给出的样例代码：

# 利用这个方法和类属性的特性可以实现设计模式中的单例模式单例模式是指创建唯一对象码，单例模式设计的类只能实例化一个对象.
class Singleton(object):
    __instance = None                       # 定义实例

    def __init__(self):
        pass

    def __new__(cls, *args, **kwd):         # 在__init__之前调用
        if Singleton.__instance is None:    # 生成唯一实例
            Singleton.__instance = object.__new__(cls, *args, **kwd)
        else:
            raise Exception('!')
        return Singleton.__instance

在这个样例中，__new__ 方法是一个会在 __init__ 方法之前调用的魔术方法，通常用于在类的实例化之前做一些特殊的判断和处理。

这里通过定义一个类属性 __instance 用来存储这个类的实例，这个属性刚开始的初始值是 None 。在每次类实例化之前，__new__ 方法里面会先对这个类属性进行判断，如果这个类属性是 None，则代表这个类没有实例化过，那么则调用父类 object 的 __new__ 方法去进行类的实例化，将获得的对象返回给 __instance 属性。如果这个类属性已经有了值，则表示这个类已经实例化过了，所以会返回一个报错。

发现问题

在这个代码当中，我们暂且无视为什么 object.__new__ 会重新调用这个类的 __init__ 方法，从这个 __new__ 方法的调用时的参数不难看出，这些参数会作为 __init__ 的参数。但是实际上在使用的时候，上面这个代码按照下面的方式生成对象，就会出现报错：

Singleton(123)	# 随便传入一个值当做变量

# 出现报错
Traceback (most recent call last):
Singleton.__instance = object.__new__(cls, *args, **kwd)
TypeError: object.__new__() takes exactly one argument (the type to instantiate)

解决方法

删除 object.__new__ 调用的时候的参数即可，而且这种删除并不会影响 __init__ 的参数传递。

# 利用这个方法和类属性的特性可以实现设计模式中的单例模式单例模式是指创建唯一对象码，单例模式设计的类只能实例化一个对象.
class Singleton(object):
    __instance = None                       # 定义实例

    def __init__(self):
        pass

    def __new__(cls, *args, **kwd):         # 在__init__之前调用
        if Singleton.__instance is None:    # 生成唯一实例
            Singleton.__instance = object.__new__(cls)	# 删除其它参数即可
        else:
            raise Exception('!')
        return Singleton.__instance

原因推测

通过网络上查找，发现是因为 py2 和 py3 的区别，导致的这个问题的产生。虽然我们用的是 py3 的写法，但是底层运行是按照 py2 运行的。具体原因不知道 。所以我们只需要认为 __new__ 的使用方式是在里面调用的时候不用传递其它参数就行了。