Python 3.12+如何在抽象类中声明私有抽象属性？

首先明确：Python中没有真正的私有属性，__前缀的属性只是做了名称修饰（会被转为_类名__属性名），这种修饰会导致子类的__my_prop和父类的__my_prop是完全不同的属性，无法实现“强制子类拥有同名私有属性”的约束。你的核心需求其实是强制子类必须拥有一个内部的、对外不可直接访问的属性，以下是符合Python风格的实现方式：

方案一：用抽象方法强制子类初始化受保护属性（推荐） #

利用抽象类的@abstractmethod强制子类实现初始化逻辑，确保_my_prop（用单下划线表示受保护，这是Python社区约定的“私有”规范）存在：

from abc import ABC, abstractmethod
from typing import TypeVar

MyType = TypeVar('MyType')

class MyAbstractClass(ABC):
    @abstractmethod
    def __init__(self, param: MyType):
        # 父类中定义初始化逻辑，子类必须调用或重写
        self._my_prop = param

class Concrete(MyAbstractClass):
    def __init__(self, param: MyType):
        # 调用父类初始化逻辑，确保 _my_prop 被设置
        super().__init__(param)
        # 子类可添加自定义初始化代码

如果需要更灵活的初始化逻辑，也可以单独定义抽象的初始化方法：

class MyAbstractClass(ABC):
    def __init__(self, param: MyType):
        self._init_my_prop(param)
        # 父类其他初始化逻辑

    @abstractmethod
    def _init_my_prop(self, param: MyType) -> None:
        # 强制子类实现属性初始化
        pass

class Concrete(MyAbstractClass):
    def _init_my_prop(self, param: MyType) -> None:
        self._my_prop = param

方案二：结合__init_subclass__做子类检查 #

通过__init_subclass__钩子在子类定义时检查是否声明了目标属性的类型注解，再在实例化时验证属性是否存在：

class MyAbstractClass(ABC):
    def __init_subclass__(cls, **kwargs):
        super().__init_subclass__(**kwargs)
        # 检查子类是否声明了 _my_prop 的类型注解
        if '_my_prop' not in cls.__annotations__:
            raise TypeError(f"子类 {cls.__name__} 必须声明 _my_prop 属性")

    def __init__(self, param: MyType):
        # 实例化时验证属性是否被初始化
        if not hasattr(self, '_my_prop'):
            raise NotImplementedError("子类必须初始化 _my_prop 属性")

class Concrete(MyAbstractClass):
    _my_prop: MyType

    def __init__(self, param: MyType):
        self._my_prop = param
        super().__init__(param)

关键说明 #

1. 为什么不用__my_prop？
   父类的__my_prop会被修饰为_MyAbstractClass__my_prop，子类中定义的__my_prop会变成_Concrete__my_prop，二者是完全独立的属性，父类无法约束子类的__my_prop，也无法访问子类的这个属性，不符合你的需求。

2. 关于“只读”需求
   如果需要属性只读，可以回到你最初的抽象@property方案，只实现getter不定义setter：

   class MyAbstractClass(ABC):
       @property
       @abstractmethod
       def my_prop(self) -> MyType:
           pass
   
   class Concrete(MyAbstractClass):
       def __init__(self, param: MyType):
           self._my_prop = param
   
       @property
       def my_prop(self) -> MyType:
           return self._my_prop
   

   这种方式对外暴露只读的my_prop，内部用_my_prop存储，符合Python的封装规范。

内容的提问来源于stack exchange，提问作者lsc