抽象接口设计的核心目标是解耦模块依赖，仅通过行为契约协作以提升可维护性、可测试性和扩展性；需用abc.ABC定义清晰契约，遵循依赖倒置原则，从实际变化点出发，配合类型提示强化约束。
抽象接口设计的核心目标是让代码各模块之间不直接依赖具体实现，只通过约定好的行为契约协作。这能显著提升可维护性、可测试性和扩展性。
用 ABC 定义清晰的行为契约
Python 的 abc.ABC 是表达“必须提供哪些方法”的最直接方式。它不是为了强制类型检查，而是明确告诉使用者：“只要实现了这些方法，你就符合这个角色”。比如定义一个数据加载器接口：
- 继承
ABC，用@abstractmethod标记关键方法（如load()、supports_format()） - 不写任何实现逻辑，也不设默认参数或内部状态
- 方法签名要稳定——参数名、类型提示、返回值含义都需有业务意义，例如
load(self, source: str) -> dict比load(self, x) -> Any更利于协作
依赖倒置：高层模块只导入接口，不导入实现
业务逻辑层（如报表生成器）不应 import 具体的 CsvLoader 或 JsonLoader，而应只依赖 DataLoader 接口。实现类由外部注入：
- 构造函数接收接口类型参数：
def __init__(self, loader: DataLoader): ... - 工厂函数或配置驱动选择具体实现：
loader = CsvLoader() if config.format == "csv" else JsonLoader() - 单元测试时可轻松传入 Mock 实现，无需启动真实文件系统
避免过度抽象，从实际变化点出发
不要一上来就为所有类建接口。先观察哪些部分真正需要替换或隔离：
立即学习“Python免费学习笔记（深入）”；
- 外部服务调用（数据库、HTTP API、消息队列）——网络不稳定、环境差异大，适合抽象
- 算法策略（排序、校验、编码）——业务规则可能随政策/场景调整，适合用策略接口
- 但像
User.name这样的简单属性访问，没必要抽象成INameProvider
配合类型提示强化契约意识
typing.Protocol 提供了更轻量的结构化协议支持，适合“鸭子类型”场景；而 Union[ImplA, ImplB] 不如直接注解为接口类型清晰。在 IDE 和 mypy 中：
- 给变量、参数、返回值标注接口类型，如
def process(loader: DataLoader) -> list[Record]: - 启用
--disallow-untyped-defs和--check-untyped-defs，让类型系统帮你守住边界 - 接口中用
Optional[]、Literal[]明确表达可选行为或有限取值，比文档更可靠
接口不是越多越好，关键是让变化的部分有替换入口，让稳定的部分保持简洁。写完一个接口后，问自己：现在换掉它的实现，是否真的不改一行业务逻辑就能跑通？如果答案是肯定的，那这个抽象就立住了。
