本文详解python中类变量与实例变量的本质差异，重点说明为何将字典等可变对象声明为类变量会导致多实例间数据污染，并通过vector示例代码直观演示错误成因与正确写法。
本文详解python中类变量与实例变量的本质差异，重点说明为何将字典等可变对象声明为类变量会导致多实例间数据污染，并通过vector示例代码直观演示错误成因与正确写法。
在Python面向对象编程中，变量定义位置直接决定其作用域与生命周期——这是理解类行为的核心前提。如示例所示，若将 vecDict = {} 声明在类体顶层（即 __init__ 外），它将成为类变量（Class Variable）；而放在 __init__ 中并用 self.vecDict = {} 赋值，则创建的是实例变量（Instance Variable）。二者根本区别在于：类变量被该类所有实例共享，而实例变量则独属于每个对象。
为什么类变量初始化会导致“错误结果”？
考虑以下错误写法：
class Vector:
vecDict = {} # ⚠️ 危险！类变量——所有实例共用同一字典
def __init__(self, nums):
for i, val in enumerate(nums):
self.vecDict[i] = val # 直接修改共享字典！当执行：
v1 = Vector([1, 0, 0, 2, 3]) v2 = Vector([0, 3, 0, 4, 0]) print(v1.dotProduct(v2)) # 输出远非预期的8，甚至可能报错或返回异常大值
此时 v1 和 v2 共享同一个 vecDict。v2.__init__ 执行时会覆盖/追加 v1 已存的键值对，导致 v1.vecDict 实际包含 [0:0, 1:3, 2:0, 3:4, 4:0] —— 完全破坏了稀疏向量的原始结构。后续 dotProduct 计算基于被污染的数据，结果必然错误。
立即学习“Python免费学习笔记（深入）”；
正确做法：始终在 __init__ 中初始化可变实例变量
class Vector:
def __init__(self, nums):
self.vecDict = {} # ✅ 正确！每个实例拥有独立字典
for i, val in enumerate(nums):
if val != 0: # 稀疏向量优化：仅存储非零值
self.vecDict[i] = val
def getDict(self):
return self.vecDict
def dotProduct(self, vec):
dot_prod = 0
for idx, val in self.vecDict.items():
if idx in vec.vecDict: # 利用哈希表O(1)查找
dot_prod += val * vec.vecDict[idx]
return dot_prod✅ 关键保障：每次实例化都调用 __init__，self.vecDict = {} 创建全新空字典，确保各实例数据完全隔离。
注意事项与最佳实践
- 可变对象（list、dict、set）绝不可作为类变量默认值：class C: data = [] 是经典反模式，易引发静默bug。
- 类变量适用于常量或需全局共享的状态：如 MAX_SIZE = 100、version = "1.2"。
- 验证变量归属：可通过 id(obj.attr) 检查不同实例的属性是否指向同一内存地址。
- PEP 8建议：实例变量应在 __init__ 中显式初始化，提升代码可读性与可维护性。
掌握类变量与实例变量的边界，是写出健壮Python类的第一道防线。记住：“共享即风险，独有才安全” —— 尤其面对可变对象时，务必让每个实例拥有自己的数据副本。
