classmethod

在 Python 里classmethod是一个挺有意思的东西。很多人刚开始接触它的时候可能会觉得有点绕尤其是它和staticmethod放在一起的时候更容易让人犯迷糊。不过一旦理解了它的设计意图和使用场景就会发现它其实是一个很自然、很实用的工具。简单来说classmethod是一个装饰器用来修饰类中的某个方法。被它修饰的方法第一个参数不再是常见的self而是cls。这个cls指的就是类本身而不是某个具体的实例。这样一来这个方法就可以在不创建实例的情况下通过类名直接调用并且在方法内部可以访问和操作类级别的属性和状态。举个例子可能会更清楚一些。假设你在写一个简单的类用来表示不同类型的咖啡。每种咖啡都有名字和价格你可能会这样写classCoffee:def__init__(self,name,price):self.namename self.priceprice这样写没问题但有时候你可能会遇到一些固定的咖啡类型比如“美式”或者“拿铁”它们的价格是相对固定的。如果每次创建实例都要手动传入名字和价格不仅麻烦还容易出错。这时候classmethod就可以派上用场了。你可以为这些固定的咖啡类型创建一些工厂方法像这样classCoffee:def__init__(self,name,price):self.namename self.pricepriceclassmethoddefamericano(cls):returncls(Americano,25)classmethoddeflatte(cls):returncls(Latte,30)现在如果你想创建一杯美式咖啡不需要再手动指定名字和价格直接调用Coffee.americano()就可以了。这个方法会返回一个新的Coffee实例名字是“Americano”价格是 25。注意这里用的是cls而不是Coffee这样做的好处是如果以后这个类被继承子类调用这个类方法时cls会自动指向子类返回的也是子类的实例保持了多态性。这种用法在 Django 的模型类里很常见。Django 的模型经常提供一些类方法用来创建具有特定状态的实例或者执行一些与类相关的查询操作。比如你可能会看到User.objects.create_user()这样的方法它本质上就是一个类方法封装了创建用户的逻辑。除了作为工厂方法classmethod还经常用在替代构造函数的场景里。有时候初始化实例的参数来源可能比较复杂比如来自一个字典或者需要经过一些解析处理。这时候你可以定义一个类方法来处理这些逻辑然后返回初始化好的实例。这样做的好处是可以把复杂的初始化逻辑封装起来让调用方用起来更简单也更不容易出错。比如你的咖啡数据可能来自一个 JSON 字符串你可以这样写classCoffee:def__init__(self,name,price):self.namename self.pricepriceclassmethoddeffrom_json(cls,json_str):importjson datajson.loads(json_str)returncls(data[name],data[price])这样当你从外部接收到一个 JSON 字符串时只需要调用Coffee.from_json(json_str)就能得到一个对应的实例。这种模式在 Python 的标准库和很多第三方库里都能看到是一种很常见的做法。说到这里可能有人会问classmethod和staticmethod到底有什么区别它们看起来好像都能通过类名直接调用都不需要实例。区别其实就在那个第一个参数上。staticmethod就是一个普通的函数只是刚好放在类里而已它既不能访问实例属性也不能访问类属性。而classmethod可以访问类属性也可以修改类状态因为它接收类本身作为参数。举个例子假设你想跟踪一共创建了多少杯咖啡你可以在类里加一个计数器classCoffee:_count0def__init__(self,name,price):self.namename self.priceprice Coffee._count1classmethoddefget_count(cls):returncls._count这里get_count是一个类方法它返回当前已经创建的咖啡数量。因为_count是一个类属性所以通过cls可以访问到它。如果你用staticmethod来写就做不到这一点除非你硬编码类名但那样就失去了多态性也不够灵活。在实际开发中classmethod的使用频率其实比staticmethod要高得多。因为大多数情况下当你需要一个不需要实例就能调用的方法时你往往还是需要和类本身打交道比如访问类属性、调用其他类方法或者创建新的实例。这时候classmethod就是更合适的选择。当然并不是说staticmethod就完全没用。如果你确实有一个纯粹的工具函数它和类的关系不大只是放在类里比较合适那么用staticmethod也是可以的。但这种情况相对少见更多的时候classmethod才是你需要的。理解classmethod的关键在于理解它和类的关系。它把类作为一个可操作的对象让你可以在更高的层次上组织代码。这种设计在很多地方都能看到比如单例模式、工厂模式或者一些元编程的场景里。当你习惯了这种思维方式你会发现写出更清晰、更灵活的代码其实并不是一件难事。最后再提一个小细节。在 Python 3 里classmethod还可以和property装饰器一起使用创建类级别的属性。这算是一个比较高级的用法但在某些场景下也挺有用的。比如你想暴露一个类级别的只读属性就可以这样写classCoffee:_types[Americano,Latte,Espresso]classmethodpropertydeftypes(cls):returncls._types.copy()这样你可以通过Coffee.types获取到咖啡类型的列表而且返回的是副本避免了外部修改影响内部状态。不过这种用法在 Python 3.9 之后才被正式支持需要注意一下版本兼容性。总的来说classmethod是 Python 面向对象编程中一个很实用的特性。它让你能够更自然地操作类写出更模块化、更易维护的代码。下次当你遇到需要在不创建实例的情况下执行一些与类相关的操作时不妨考虑一下它。