子类直接赋值覆盖父类类属性实为遮蔽而非真正覆盖，应优先用子类定义体声明、__init_subclass__ 初始化或实例属性替代，配合ClassVar标注和文档说明实现优雅覆盖。
子类直接赋值覆盖父类类属性会破坏继承关系
Python中如果子类直接用 ClassName.attr = value 覆盖父类的类属性，这个操作实际是在子类对象上新增一个同名属性，而父类的类属性本身没变。但后续通过子类访问时，会优先取子类自己的属性，看起来像“覆盖”，实则是遮蔽（shadowing）。这种写法在多继承或动态检查时容易出问题，比如 isinstance 或 issubclass 判断不受影响，但 getattr(Parent, 'attr') 和 getattr(Child, 'attr') 返回不同值，逻辑割裂。
常见错误现象：父类有默认配置 DEFAULT_TIMEOUT = 30，子类写 Child.DEFAULT_TIMEOUT = 60 后，若父类某方法内部用 self.__class__.DEFAULT_TIMEOUT 做分支判断，子类实例调用时可能仍走父类逻辑路径——因为该方法里没显式限定从当前类取，而是依赖 self.__class__ 动态解析，结果反而出人意料。
- 真正需要覆盖时，应明确在子类定义体中声明，如
class Child(Parent): DEFAULT_TIMEOUT = 60 - 若需运行时动态设置，优先用实例属性（
self._timeout）+ 属性代理（@property）控制读写逻辑 - 避免在模块顶层或类外直接对子类做
Child.attr = ...赋值，这会让类状态变得隐晦且不可追溯
用 @classmethod + __init_subclass__ 控制子类属性初始化时机
当子类必须基于父类某个类属性派生新值（比如注册表、枚举前缀），靠简单赋值无法保证执行顺序或一致性。此时应把初始化逻辑收口到父类中，利用 __init_subclass__ —— 它在子类创建完成、但尚未被导入其他模块使用前触发，是唯一可靠的“子类诞生钩子”。
使用场景：父类维护一个全局 _registry = {}，子类需自动注册自身；或子类需根据父类 _base_name 拼出唯一标识符。
-
__init_subclass__的参数可接收子类显式传入的配置，如class Child(Parent, auto_register=True) - 不要在
__init_subclass__中修改父类的类属性（如Parent._registry），除非你确定这是单例共享行为；更安全的做法是让每个子类管理自己的副本 - 若需延迟计算（比如依赖子类已定义的其他属性），可在
__init_subclass__中调用getattr(cls, 'some_attr', None)判断是否存在，避免AttributeError
class Plugin:
_registry = {}
def __init_subclass__(cls, name=None, **kwargs):
super().__init_subclass__(**kwargs)
# 确保子类定义了 name，否则用类名
real_name = name or cls.__name__
cls._registry[real_name] = cls
实例属性 vs 类属性：90% 的“覆盖需求”其实该用实例层
很多所谓“子类覆盖父类属性”的诉求，本质是希望不同子类实例表现不同，而非改变类本身的契约。例如数据库连接的 host、HTTP客户端的 base_url。这类值天然属于实例上下文，硬塞进类属性会导致所有实例共享，一旦某个实例修改就污染全局。
性能影响：类属性在内存中只存一份，实例属性每个对象独有一份。但现代Python的实例字典优化（__slots__）已大幅缩小开销差距；而类属性滥用带来的线程不安全、测试隔离难、热重载失败等问题，代价远高于内存。
- 把配置项挪到
__init__中，用self._host = kwargs.pop('host', self.__class__.DEFAULT_HOST) - 用
@property封装读取逻辑，内部可按需 fallback 到类属性或环境变量 - 若真要“类级别差异化”，优先考虑用
functools.singledispatchmethod或策略模式，而不是让类属性承担运行时分支职责
用 typing.ClassVar 显式标注类属性，减少误改风险
类型提示不是运行时约束，但它能被mypy、pyright等工具识别，在IDE中高亮出“此处不该被实例修改”的意图。当父类定义 DEFAULT_RETRIES: ClassVar[int] = 3，子类若在 __init__ 中写 self.DEFAULT_RETRIES = 5，静态检查器会报错；同理，子类体外的 Child.DEFAULT_RETRIES = 5 虽不报错，但至少提醒开发者：这是类层级的常量，随意覆盖需三思。
容易踩的坑：把 ClassVar 和 Final 混用。前者只表示“这是类变量”，后者才表示“不可再赋值”。若真要禁止覆盖，得写 DEFAULT_RETRIES: ClassVar[Final[int]] = 3，且需配合 mypy --disallow-any-expr 等严格选项。
-
ClassVar必须配合类型注解使用，仅写DEFAULT_RETRIES = 3不会触发任何检查 - 子类中重新注解同名变量（如
DEFAULT_RETRIES: ClassVar[int] = 5）是合法的，表示有意覆盖——这正是你想要的“优雅覆盖”方式 - 别忘了在父类文档字符串里说明该类属性的设计意图，比如“供子类覆写以调整默认行为”
类属性覆盖的“优雅”不在于语法多简洁，而在于谁负责初始化、何时生效、能否被静态分析捕获。多数时候，把逻辑从类层级下移到实例层，反而更清晰、更易测、更少意外。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
