Python实例属性与类属性的区别及修改影响

一、核心定义与底层命名空间模型

理解类属性与实例属性区别的前提，是清楚它们在 Python 解释器内部的存储位置。在 Python 中，“一切皆对象”，类本身也是一个在内存中存在的对象（即 type 的实例）。因此，类对象和由它实例化出的各个实例对象，分别拥有各自独立的命名空间字典，即 __dict__。

1. 类属性的定义与存储

类属性直接定义在类体内部、任何方法函数之外。当 Python 解释器加载类定义语句块时，就会执行这些赋值代码，并将属性名与对应值写入类对象的 __dict__ 中（底层表现为 mappingproxy 字典代理）。整个进程生命周期中，只要类未被销毁，类属性就只有一份存储空间，所有创建出的实例默认共享这份数据。

2. 实例属性的定义与存储

实例属性通常在类的构造方法 __init__(self, ...) 中通过 self.属性名 = 值 显式绑定。每次执行类的实例化调用时，Python 都会在堆内存中开辟一块新的独立实例空间，并为其分配专属于该对象的 __dict__ 普通字典。实例属性的读写仅作用于当前实例自身，不同实例之间的同名实例属性完全隔离。

class Worker:
    # 类属性：定义在类体中，所有工人共享
    company = "TechCorp"
    min_salary = 8000

    def __init__(self, name, department):
        # 实例属性：绑定在具体对象 self 上，各自独立
        self.name = name
        self.department = department

# 实例化两个不同的员工对象
w1 = Worker("Alice", "研发部")
w2 = Worker("Bob", "测试部")

# 检查各自底层的 __dict__ 字典
print("w1 的实例命名空间:", w1.__dict__)
print("w2 的实例命名空间:", w2.__dict__)
print("Worker 的类命名空间是否包含 company:", 'company' in Worker.__dict__)
print("w1 的实例命名空间是否包含 company:", 'company' in w1.__dict__)

从输出可以清楚看到：company 只保存在 Worker.__dict__ 中，w1.__dict__ 与 w2.__dict__ 内部压根不存在 company 这个键。但当我们执行 print(w1.company) 时，控制台依然能够输出 "TechCorp"，这正是因为 Python 拥有一套严谨的属性查找回退机制。

图 1：Python 实例与类在内存命名空间中的存储拓扑结构

二、属性读取机制与查找解析链条

当开发者编写 value = obj.attr 读取一个属性时，Python 解释器并非盲目搜索，而是依照明确的层级链条执行解析。对于常规对象属性（非数据描述符），其查找流程如下：

1. 检查实例自身命名空间：首先在 obj.__dict__ 中查找是否存在键 'attr'。如果存在，立即返回其对应值，查找终止。这就是为什么实例属性拥有天然的最高读取优先级。
2. 回退至类对象命名空间：若实例字典中不存在该键，Python 会通过对象的 __class__ 指针跳转到 type(obj).__dict__ 中查找。如果命中类属性，则返回其值。若涉及继承结构，还会按照类的 MRO（方法解析顺序列表）沿着父类链逐级向上查找。
3. 触发动态兜底方法：如果沿整条继承链均未找到对应属性，且类中定义了 __getattr__(self, name) 方法，则执行该方法；若未定义或该方法再次报错，最终抛出 AttributeError 异常。

class Device:
    category = "IoT"     # 类属性

    def __init__(self, serial_no):
        self.serial_no = serial_no  # 实例属性

dev = Device("SN-8801")

# 1. 直接命中实例属性
print("读取 serial_no:", dev.serial_no)

# 2. 实例字典无 category，回退命中类属性
print("读取 category:", dev.category)

# 3. 实例和类字典均无此属性，触发 AttributeError
try:
    print(dev.firmware_version)
except AttributeError as e:
    print("捕获错误:", e)

图 2：实例访问属性 obj.attr 的底层查找与决策链路

三、属性修改的实际影响与三大典型场景

在日常开发中，许多隐蔽的 Bug 源于混淆了“修改类属性”与“通过实例赋值”。属性修改的行为取决于修改的发起者是类还是实例，以及属性本身是不可变类型（如 str, int）还是可变对象（如 list, dict）。

场景一：通过类对象直接修改类属性（全局同步）

通过类名直接赋值（例如 Worker.company = "NewTech"），修改的目标是类对象的命名空间 Worker.__dict__。由于所有实例在读取该属性时均回退指向此类空间，因此所有尚未覆盖该属性的既有实例以及未来新建的实例，读取到的值都会立即更新。

class Worker:
    company = "TechCorp"

w1 = Worker()
w2 = Worker()

print("修改前 w1:", w1.company)
print("修改前 w2:", w2.company)

# 通过类对象修改类属性
Worker.company = "GlobalNext"

print("修改后 w1:", w1.company)
print("修改后 w2:", w2.company)
print("新实例 w3:", Worker().company)

场景二：通过实例赋值试图修改类属性（属性遮蔽效应）

很多初学者常犯的错误，是误以为 w1.company = "MyStudio" 可以改变类属性。在 Python 中，赋值操作符 = 针对实例对象执行时，其语义是“在当前实例命名空间中创建或重写键”，而绝不会向上穿透到类命名空间！

当执行 w1.company = "MyStudio" 后：

• w1.__dict__ 中新增了 'company': 'MyStudio'。
• Worker.__dict__['company'] 依然保持原值不变。
• 后续再次访问 w1.company 时，依据第一步的查找机制，直接命中 w1.__dict__，原本的类属性被“遮蔽（Shadowed）”。
• 其他实例（如 w2.company）因为自身字典依然为空，仍然回退读取 Worker.company，完全不受影响。

class Worker:
    company = "TechCorp"

w1 = Worker()
w2 = Worker()

# 试图通过实例对象进行赋值
w1.company = "MyStudio"

print("w1.company:", w1.company)          # 命中 w1 实例属性
print("w2.company:", w2.company)          # 依旧回退到类属性
print("Worker.company:", Worker.company)  # 类属性未曾改变！

print("w1 的命名空间:", w1.__dict__)
print("w2 的命名空间:", w2.__dict__)

# 若手动删除 w1 的实例属性，遮蔽解除，重新回退至类属性
del w1.company
print("del 后 w1.company:", w1.company)

场景三：就地修改可变类属性（共享内存引用陷阱）

比遮蔽效应更隐蔽的是可变对象作为类属性的情况。如果在类定义中声明了一个空列表或字典（如 skills = []），然后通过实例调用该对象的方法（如 w1.skills.append("Python")），此时没有发生赋值操作符 =，因此 Python 不会在 w1 内部创建新的实例属性！

其实际执行路径为：先从类中回退查找到 Worker.skills 指向的堆内存列表引用，随后直接在该引用所指的内存地址进行原位追加。其结果是：所有共享该类属性的实例都会看到列表被修改！

class Employee:
    skills = []  # 错误做法：使用可变容器作为类属性以图存储个人技能

e1 = Employee()
e2 = Employee()

# e1 原位修改列表，无赋值语句
e1.skills.append("Python")

print("e1 skills:", e1.skills)
print("e2 skills:", e2.skills)  # e2 被意外污染！
print("Employee skills:", Employee.skills)
print("e1.__dict__ 是否存在 skills:", 'skills' in e1.__dict__)

图 3：三种属性修改路径的作用域与内存影响对照

四、总结与工程实践选型建议

为了在实际架构与业务开发中做出合理决策，我们可以将类属性与实例属性的核心特性提炼归纳为如下对照矩阵：

图 4：属性类型选型决策树与工程规范

工程落地三大准则

• 准则 1：类属性修改必须通过类名显式调用。在代码中永远使用 ClassName.attr = new_val 修改类属性，杜绝使用 self.attr = new_val 试图更改全局属性的危险写法。
• 准则 2：常量使用全大写命名区分。若类属性作为不可变常量（如 DEFAULT_TIMEOUT = 30），采用 PEP 8 推荐的全大写命名法，向维护者传达“只读配置”的意图。
• 准则 3：严禁可变默认容器置于类级。列表、字典等结构除非用于跨实例共享的全局 Registry 或 Cache，否则一律在 __init__ 构造器内完成实例化。