Python用ABC实现强制接口(需继承+运行时检查),用Protocol实现结构化接口(鸭子类型+静态检查);接口应聚焦行为、小而专注、命名清晰,并配合类型提示。

Python 中没有内置的接口语法,但可以通过抽象基类(ABC)或协议(Protocol)来实现接口设计,核心目标是定义行为契约,让不同类能以统一方式被使用。
用抽象基类(ABC)定义强制接口
适合需要运行时类型检查、明确要求子类必须实现某些方法的场景。继承 abc.ABC,用 @abstractmethod 标记必须实现的方法。
例如:
from abc import ABC, abstractmethodclass PaymentProcessor(ABC): @abstractmethod def charge(self, amount: float) -> bool: pass
@abstractmethod def refund(self, amount: float) -> bool: passclass StripeProcessor(PaymentProcessor): def charge(self, amount: float) -> bool: print(f"Charging ${amount} via Stripe") return True
def refund(self, amount: float) -> bool: print(f"Refunding ${amount} via Stripe") return True
立即学习“Python免费学习笔记(深入)”;
这是一款比较精美的企业网站管理系统源码,功能比较完整,比较适合新手学习交流使用,也可以作为毕业设计或者课程设计使用,感兴趣的朋友可以下载看看哦。功能介绍:该源码主要包括前台和后台两大部分,具体功能如下:网站前台模块:主要包括企业简介、新闻中心、产品展示、公司证书、工程业绩、联系我们、客户系统、人才招聘等信息的浏览,以及客户留言的功能。网站后台模块1、常规管理:企业简介、链接管理、投票管理、系统设置
未实现抽象方法的子类实例化时会报错,保障了接口一致性。
用 Protocol 实现结构化接口(推荐用于鸭子类型)
从 Python 3.8 起支持,更轻量、不参与继承体系,只关注“有没有对应方法和签名”,符合 Python 的鸭子类型哲学。适合类型提示和静态检查(如 mypy)。
例如:
from typing import Protocolclass Drawable(Protocol): def draw(self) -> None: ... def bounding_box(self) -> tuple[float, float, float, float]: ...
def render(shape: Drawable) -> None: shape.draw() # 类型检查器知道 shape 一定有 draw 方法
class Circle: def draw(self) -> None: print("Drawing a circle")
def bounding_box(self) -> tuple[float, float, float, float]: return (0.0, 0.0, 1.0, 1.0)render(Circle()) # ✅ 无需显式继承,只要结构匹配即可
接口设计的关键实践
- 聚焦行为,而非数据:接口应描述“能做什么”,而不是“是什么”;避免在接口中定义属性或状态字段
-
保持小而专注:一个接口只表达一种能力(如
Serializable、Comparable),便于组合和复用 -
方法命名清晰,参数简洁:避免过载或模糊语义,比如用
save_to(file_path: str)比write(obj)更明确 - 配合类型提示使用:无论 ABC 还是 Protocol,加上完整类型注解能显著提升可维护性和工具支持度
什么时候选 ABC?什么时候选 Protocol?
- 需要强制子类实现、运行时检查(如插件系统注册校验)→ 用
ABC - 强调灵活性、兼容已有类、侧重静态类型检查 → 用
Protocol - 想让接口既可被继承又可被结构匹配 → 可同时提供 ABC 和 Protocol 版本(少数严谨库采用)









