在B站的【408实验室】所发布的《Python完全自学教程》中https://space.bilibili.com/157232748/lists/8219076专门讲解了类方法、静态方法和实例方法等有关内容为了让学习者能够更深刻理解它们再以本文专门探讨实例方法、类方法和静态方法之间的区别以及如何判断哪种情况该用哪个。以下是一个简单的决策规则。1. 决策规则观察该方法实际触及的内容需要实例self → 实例方法需要类cls但不需要特定实例 →classmethod两者都不需要 →staticmethod实际有哪些使用场景假设以下create方法它不符合上述规则。它接收与__init__相同的参数并直接传递。虽然它提供了一个不错的接口Class.create(...)但没有做任何构造函数尚未完成的工作# 为清晰起见进行了简化classmethoddefcreate(cls,amount:Decimal,currency:CurrencyCurrency.EUR)-Expense:returncls(amountamount,currencycurrency)2. 当 classmethod 真正体现价值时当类方法完成了构造函数不应承担的工作或从不同的起点构建对象时它才发挥了真正的作用。加入一个归一化步骤同一个方法便立即有了存在的意义classmethoddefcreate(cls,amount:Decimal,currency:CurrencyCurrency.EUR)-Expense:returncls(amountamount.quantize(Decimal(0.01)),currencycurrency)classmethod的典型用法是作为替代构造函数。Python 不允许重载__init__因此当需要以多种方式构建对象时每种方式就成为一个类方法。标准库中提供了丰富的例子例如datetime.datedate.today()# 从系统时钟构建date.fromtimestamp(1718539200)# 从 POSIX 时间戳构建date.fromisoformat(2026-06-16)# 从 ISO 8601 字符串构建date.fromordinal(739418)# 从预推格里高利历序数构建date.fromisocalendar(2026,25,1)# 从 ISO 年/周/日构建源码# 附加构造函数classmethoddeffromtimestamp(cls,t):从 POSIX 时间戳例如 time.time()构建日期。iftisNone:raiseTypeError(NoneType object cannot be interpreted as an integer)y,m,d,hh,mm,ss,weekday,jday,dst_time.localtime(t)returncls(y,m,d)classmethoddeftoday(cls):从 time.time() 构建日期。t_time.time()returncls.fromtimestamp(t)......以上每个方法都返回一个date但使用的原始材料各不相同。它们必须是类方法因为需要cls来构造实例并且返回cls(...)也使得子类能够正常工作。例如如果MyDate是date的子类那么MyDate.today()将返回MyDate实例而不是date。你会在整个生态中看到相同的模式dict.fromkeys(...)、int.from_bytes(...)以及 Pydantic 中的Model.model_validate(...)/model_validate_json(...)都是类方法它们从不同的原始材料构建实例。另一个classmethod的用例是类级状态注册表、缓存、计数器。插件注册表是一个清晰的例子因为该方法读取并修改的是属于类而非任何实例的状态classHandler:_registry:dict[str,type[Handler]]{}classmethoddefregister(cls,name:str,handler:type[Handler])-None:cls._registry[name]handlerclassmethoddefget(cls,name:str)-type[Handler]:returncls._registry[name]# 在类上调用无需实例它修改的是存活在类上的状态Handler.register(json,JSONHandler)3. 什么时候确实是 staticmethod如果方法既不触及self也不触及cls它就是一个静态方法即一个恰好因命名空间而位于类内部的普通函数。当辅助函数与类紧密耦合且你希望Expense.normalize(...)读起来顺畅时这是合理的选择。此时它成为类 API 的一部分会出现在dir(Expense)中且无需实例即可调用。真正的静态方法比前两者更为少见这本身就能说明一些问题。一个清晰的例子是带有颜色转换辅助方法的Color类classColor:def__init__(self,name:str):self.namename self.rgbCOLOR_NAMES.get(name.upper())staticmethoddefhex2rgb(hex_value:str)-tuple[int,int,int]:returntuple(int(hex_value[i:i2],16)foriin(1,3,5))staticmethoddefrgb2hex(rgb:tuple[int,int,int])-str:returnf#{rgb[0]:02x}{rgb[1]:02x}{rgb[2]:02x}hex2rgb和rgb2hex既不触及实例也不触及类。它们是纯粹的函数式转换位于Color上使得Color.hex2rgb(#ff0000)在与 API 其他部分并列时读起来很自然。但这正是值得注意的信号静态方法可能只是伪装成方法的函数有时更诚实的做法是将其提取为模块级函数这样更容易测试和独立使用。4. 总结方法类型第一个参数可访问内容常见用例实例方法self实例及类状态修改对象状态类方法 (classmethod)cls仅类状态替代构造函数、注册表静态方法 (staticmethod)无两者均不可孤立的工具/辅助函数5. 为什么这在当下更重要当自己编写代码时你几乎不会无理由地添加一个方法。而当智能体agent编写代码时你会得到一个看似合理却未经人为选择的结构一个什么也不做的create类方法一个本该是独立函数的静态方法一个挂载在错误类上的辅助方法。这就需要你做出判断该方法所完成的工作是否真正属于该类还是这仅仅是智能体从其他代码中学到的一种模式放慢速度以批判的眼光审视任何代码并提出这些问题是值得的。随着 AI 更快地产出更多代码我们很容易认为“看起来像 Python 就是好的 Python”。但智能体没有品味它会欣然生成技术上正确但结构上错误的代码。这也正是撰写此文章的原因为你提供一个简单的决策规则让你在审查时能在脑海中运行。因此请使用 AI但要持续培养自己的知识和品味。你懂得越多就越能更好地评判摆在你面前的代码——无论它是由人还是由智能体写的。
在 Python 中何时使用 classmethod、staticmethod 或实例方法
在B站的【408实验室】所发布的《Python完全自学教程》中https://space.bilibili.com/157232748/lists/8219076专门讲解了类方法、静态方法和实例方法等有关内容为了让学习者能够更深刻理解它们再以本文专门探讨实例方法、类方法和静态方法之间的区别以及如何判断哪种情况该用哪个。以下是一个简单的决策规则。1. 决策规则观察该方法实际触及的内容需要实例self → 实例方法需要类cls但不需要特定实例 →classmethod两者都不需要 →staticmethod实际有哪些使用场景假设以下create方法它不符合上述规则。它接收与__init__相同的参数并直接传递。虽然它提供了一个不错的接口Class.create(...)但没有做任何构造函数尚未完成的工作# 为清晰起见进行了简化classmethoddefcreate(cls,amount:Decimal,currency:CurrencyCurrency.EUR)-Expense:returncls(amountamount,currencycurrency)2. 当 classmethod 真正体现价值时当类方法完成了构造函数不应承担的工作或从不同的起点构建对象时它才发挥了真正的作用。加入一个归一化步骤同一个方法便立即有了存在的意义classmethoddefcreate(cls,amount:Decimal,currency:CurrencyCurrency.EUR)-Expense:returncls(amountamount.quantize(Decimal(0.01)),currencycurrency)classmethod的典型用法是作为替代构造函数。Python 不允许重载__init__因此当需要以多种方式构建对象时每种方式就成为一个类方法。标准库中提供了丰富的例子例如datetime.datedate.today()# 从系统时钟构建date.fromtimestamp(1718539200)# 从 POSIX 时间戳构建date.fromisoformat(2026-06-16)# 从 ISO 8601 字符串构建date.fromordinal(739418)# 从预推格里高利历序数构建date.fromisocalendar(2026,25,1)# 从 ISO 年/周/日构建源码# 附加构造函数classmethoddeffromtimestamp(cls,t):从 POSIX 时间戳例如 time.time()构建日期。iftisNone:raiseTypeError(NoneType object cannot be interpreted as an integer)y,m,d,hh,mm,ss,weekday,jday,dst_time.localtime(t)returncls(y,m,d)classmethoddeftoday(cls):从 time.time() 构建日期。t_time.time()returncls.fromtimestamp(t)......以上每个方法都返回一个date但使用的原始材料各不相同。它们必须是类方法因为需要cls来构造实例并且返回cls(...)也使得子类能够正常工作。例如如果MyDate是date的子类那么MyDate.today()将返回MyDate实例而不是date。你会在整个生态中看到相同的模式dict.fromkeys(...)、int.from_bytes(...)以及 Pydantic 中的Model.model_validate(...)/model_validate_json(...)都是类方法它们从不同的原始材料构建实例。另一个classmethod的用例是类级状态注册表、缓存、计数器。插件注册表是一个清晰的例子因为该方法读取并修改的是属于类而非任何实例的状态classHandler:_registry:dict[str,type[Handler]]{}classmethoddefregister(cls,name:str,handler:type[Handler])-None:cls._registry[name]handlerclassmethoddefget(cls,name:str)-type[Handler]:returncls._registry[name]# 在类上调用无需实例它修改的是存活在类上的状态Handler.register(json,JSONHandler)3. 什么时候确实是 staticmethod如果方法既不触及self也不触及cls它就是一个静态方法即一个恰好因命名空间而位于类内部的普通函数。当辅助函数与类紧密耦合且你希望Expense.normalize(...)读起来顺畅时这是合理的选择。此时它成为类 API 的一部分会出现在dir(Expense)中且无需实例即可调用。真正的静态方法比前两者更为少见这本身就能说明一些问题。一个清晰的例子是带有颜色转换辅助方法的Color类classColor:def__init__(self,name:str):self.namename self.rgbCOLOR_NAMES.get(name.upper())staticmethoddefhex2rgb(hex_value:str)-tuple[int,int,int]:returntuple(int(hex_value[i:i2],16)foriin(1,3,5))staticmethoddefrgb2hex(rgb:tuple[int,int,int])-str:returnf#{rgb[0]:02x}{rgb[1]:02x}{rgb[2]:02x}hex2rgb和rgb2hex既不触及实例也不触及类。它们是纯粹的函数式转换位于Color上使得Color.hex2rgb(#ff0000)在与 API 其他部分并列时读起来很自然。但这正是值得注意的信号静态方法可能只是伪装成方法的函数有时更诚实的做法是将其提取为模块级函数这样更容易测试和独立使用。4. 总结方法类型第一个参数可访问内容常见用例实例方法self实例及类状态修改对象状态类方法 (classmethod)cls仅类状态替代构造函数、注册表静态方法 (staticmethod)无两者均不可孤立的工具/辅助函数5. 为什么这在当下更重要当自己编写代码时你几乎不会无理由地添加一个方法。而当智能体agent编写代码时你会得到一个看似合理却未经人为选择的结构一个什么也不做的create类方法一个本该是独立函数的静态方法一个挂载在错误类上的辅助方法。这就需要你做出判断该方法所完成的工作是否真正属于该类还是这仅仅是智能体从其他代码中学到的一种模式放慢速度以批判的眼光审视任何代码并提出这些问题是值得的。随着 AI 更快地产出更多代码我们很容易认为“看起来像 Python 就是好的 Python”。但智能体没有品味它会欣然生成技术上正确但结构上错误的代码。这也正是撰写此文章的原因为你提供一个简单的决策规则让你在审查时能在脑海中运行。因此请使用 AI但要持续培养自己的知识和品味。你懂得越多就越能更好地评判摆在你面前的代码——无论它是由人还是由智能体写的。
