Python抽象属性使用解读(@property+@abstractmethod)

目录

• 1. 为什么要组合使用？
• 1.1 语义区别
• 2. 子类如何实现？
• 方式一：使用属性 (最简单推荐)
• 方式二：使用 @property 方法 (动态计算)
• 3. 完整示例对比
• 4. 总结

在 BaseLoader 代码中：

@property
@abstractmethod
def supported_extensions(self) -> list[str]:
    """Return list of supported file extensions."""
    pass

这种写法的核心目的是：定义一个只读的、强制子类提供的数据接口。

• 方法 (Method): 表示“动作”或“计算”。调用需要括号 ()。
• 属性 (Property): 表示“状态”、“特征”或“配置”。调用不需要括号。

supported_extensions 本质上是 Loader 的一种静态特征（它支持什么后缀），而不是一个动作（比如 load()）。因此，将其定义为属性在语义上更准确。

这是这种模式最强大的地方：它给了子类极大的灵活度。

父类定义了“我需要一个名为 supported_extensions 的属性”，子类可以用以下两种方式之一来满足：

这也是 Python 相比 Java 的一大优势：抽象属性可以用普通的类属性或实例属性来覆盖。

class TextLoader(BaseLoader):
    # 直接定义一个列表，甚至不需要写 @property 方法
    supported_extensions = ['.txt', '.md']

这种写法非常干净，看起来就像是在写配置文件。

如果你的属性值不是固定的，而是需要计算得来的，可以使用这种方式。

class DynamicLoader(BaseLoader):
    @property
    def supported_extensions(self) -> list[str]:
        # 假设这里有复杂的逻辑
        import os
        return os.environ.get("ALLOWED_EXTS", ".txt").split(",")

from abc import ABC, abstractmethod

class Base(ABC):
    @property
    @abstractmethod
    def config(self):
        pass

# 实现 1: 静态配置 (推荐)
class SimpleImpl(Base):
    config = {"timeout": 30}

# 实现 2: 动态逻辑
class ComplexImpl(Base):
    @property
    def config(self):
        return {"timeout": self._calculate_timeout()}

    def _calculate_timeout(self):
        return 100

# 使用
s = SimpleImpl()
print(s.config) # {'timeout': 30}

c = ComplexImpl()
print(c.config) # {'timeout': 100}

使用 @property + @abstractmethod 的好处：

1. 接口语义清晰：告诉使用者这是一个数据特征。
2. 实现灵活：子类可以简单地用变量赋值，也可以用复杂的 getter 方法。
3. 统一调用：无论子类怎么实现，使用者都用 obj.field 来访问，不需要关心背后是变量还是函数。

以上为个人经验，希望能给大家一个参考，也希望大家多多支持风君子博客。

您可能感兴趣的文章:

• 从基础到高级详解Python中接口与抽象基类的使用指南
• 一文详解python中抽象基类使用指南
• 浅析Python中接口与抽象基类的使用
• Python 中的 abc 模块之抽象类与接口
• Python Ast抽象语法树的介绍及应用详解
• Python抽象类应用详情
• Python抽象基类的定义与使用方法