类方法用@classmethod装饰器绑定类对象cls，可安全读写类变量但不可访问实例变量，适用于替代构造函数、重置计数器等场景；误用可变类变量或忽略线程安全易致数据污染。
类方法不能访问实例变量，但能安全读写类变量——这是它最核心的用途，不是“语法糖”，而是明确的职责边界。
类方法为什么必须用 @classmethod 装饰器
Python 不会自动把类当作第一个参数传给普通方法。没有 @classmethod，cls 就只是个普通形参名，不会绑定到类对象上；调用时也不会自动注入类本身。
常见错误现象：TypeError: class_method() missing 1 required positional argument: 'cls' —— 这说明你忘了加装饰器，却在方法定义里写了 cls。
使用场景：
立即学习“Python免费学习笔记（深入）”；
- 需要在不创建实例的前提下操作类状态（比如初始化配置、重置计数器）
- 实现替代构造函数（如
from_json()、from_config()） - 封装对类变量的受控修改，避免外部直接赋值破坏逻辑
cls 参数到底是什么
cls 是一个指向类对象本身的引用，和实例方法里的 self 类似，但它指向的是类，不是实例。你可以用 cls 访问类变量、调用其他类方法，甚至动态创建新实例（比如 return cls(...)）。
关键区别：
-
cls.class_variable✅ 可读可写 -
cls.instance_variable❌ 报AttributeError：类对象上根本不存在实例变量 -
self.class_variable✅ 可读（Python 会先查实例再查类），但写会新建同名实例属性，覆盖类变量访问路径
性能影响：无额外开销。cls 是纯粹的绑定传递，比反射或字符串查找快得多。
类变量被多个实例共享的真实表现
类变量不是“全局变量”，而是属于类对象的属性，所有该类的实例通过类名或 cls 共享同一份内存地址。
容易踩的坑：
- 误用可变对象作类变量（如
data = []）：所有实例会往同一个列表append，导致数据污染 - 在
__init__里直接赋值类变量（如self.counter = 0）：这会创建同名实例变量，后续self.counter就不再读取类变量了 - 跨模块修改类变量后未同步预期：比如模块 A 中
MyClass.flag = False，模块 B 仍缓存旧值，需确认导入路径一致
示例：
class Counter:
count = 0
def __init__(self):
Counter.count += 1 # 安全：显式用类名
@classmethod
def reset(cls):
cls.count = 0 # 安全：通过 cls 修改
调用 Counter.reset() 后，所有已有和未来的实例看到的 count 都是 0。
什么时候不该用类方法操作类变量
类变量适合存储真正全局、无状态依赖的共享数据。如果逻辑涉及 I/O、线程安全、或需要上下文隔离，类方法反而会掩盖问题。
典型反例：
- 用类变量存数据库连接池但没做线程锁 —— 并发下可能重复初始化或泄漏
- 在类方法里读写配置文件并缓存到类变量，但文件被外部修改后类变量不会自动更新
- 把本该由单例模式管理的状态硬塞进类变量，导致测试时无法 clean up
真正轻量、确定不变、且所有实例都应遵守的规则（比如单位换算系数、HTTP 状态码映射表），才适合用类方法+类变量组合。
