0

0

Python Protocol 的设计初衷

冷炫風刃

冷炫風刃

发布时间:2026-01-31 18:48:08

|

170人浏览过

|

来源于php中文网

原创

Protocol 的核心是让类型检查器推导结构契约而非修改运行时行为;它无需显式继承即可匹配内置或第三方类型,仅在静态检查中生效,且成员检查宽泛浅层、不校验返回值协变或嵌套协议。

python protocol 的设计初衷

Python 的 Protocol 不是用来“替代抽象基类”或“实现接口”的工具,它的核心设计初衷是:让类型检查器(如 mypy、pylance)能在不修改运行时行为的前提下,推导出对象是否满足某种结构契约。

为什么需要 Protocol 而不是继承 ABC?

ABC(ABCMeta)要求显式继承和 @abstractmethod,但很多内置类型(如 listdict)或第三方类根本没继承你的基类——它们只是恰好有 __len____getitem__。Protocol 允许你声明“只要长得像,就算数”,而无需改动原类定义。

  • 运行时不生效:Protocol 类在运行时只是普通类,不参与 isinstanceissubclass 判断
  • 仅限静态检查:mypy 看到 def func(x: Sized) 时,会检查传入对象是否有 __len__ 方法,不管它是不是 Sized 的子类
  • 避免猴子补丁或包装器:不用给 requests.Responseimplements(MyProtocol) 就能让类型检查通过

Protocol 和 typing.Protocol 的区别

typing.Protocol 是 Python 3.8+ 引入的官方协议基类;此前社区用 typing_extensions.Protocol。二者行为一致,但注意:

  • Python typing_extensions,否则报 NameError: name 'Protocol' is not defined
  • typing.Protocoltyping 模块的一部分,不是 abc.ABC 的子类,不能混用 @abstractmethod
  • 定义协议方法时,self 参数必须写,即使它不参与结构匹配(mypy 会忽略 self 类型)

常见误用:把 Protocol 当运行时接口

有人试图用 isinstance(obj, MyProtocol)MyProtocol.register(cls),这会失败——Protocol 不支持运行时注册或检查。

Wave.Video
Wave.Video

一个在线的AI自动化视频创作平台

下载

立即学习Python免费学习笔记(深入)”;

  • 错误示例:isinstance([1,2], Sized) 返回 False(尽管 mypy 认为合法)
  • 正确思路:协议只服务于类型注解 + 静态检查,运行时逻辑仍靠鸭子类型或 hasattr
  • 若需运行时判断,应单独写辅助函数,比如 def is_sized(obj) -> bool: return hasattr(obj, '__len__')

真正容易被忽略的是:Protocol 的成员访问检查是“宽泛且浅层”的——它只看属性名和方法签名是否存在,不校验返回值类型是否可协变、不深入检查嵌套协议、也不验证 __init__ 是否匹配。这意味着,协议越复杂,越容易在静态检查中“看起来对”,实际运行时报错。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
硬盘接口类型介绍
硬盘接口类型介绍

硬盘接口类型有IDE、SATA、SCSI、Fibre Channel、USB、eSATA、mSATA、PCIe等等。详细介绍:1、IDE接口是一种并行接口,主要用于连接硬盘和光驱等设备,它主要有两种类型:ATA和ATAPI,IDE接口已经逐渐被SATA接口;2、SATA接口是一种串行接口,相较于IDE接口,它具有更高的传输速度、更低的功耗和更小的体积;3、SCSI接口等等。

2042

2023.10.19

PHP接口编写教程
PHP接口编写教程

本专题整合了PHP接口编写教程,阅读专题下面的文章了解更多详细内容。

702

2025.10.17

php8.4实现接口限流的教程
php8.4实现接口限流的教程

PHP8.4本身不内置限流功能,需借助Redis(令牌桶)或Swoole(漏桶)实现;文件锁因I/O瓶颈、无跨机共享、秒级精度等缺陷不适用高并发场景。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2455

2025.12.29

java接口相关教程
java接口相关教程

本专题整合了java接口相关内容,阅读专题下面的文章了解更多详细内容。

49

2026.01.19

Python WebSocket实时通信与异步服务开发实践
Python WebSocket实时通信与异步服务开发实践

本专题聚焦 Python 在实时通信场景中的开发实践,系统讲解 WebSocket 协议原理、长连接管理、消息推送机制以及异步服务架构设计。内容包括客户端与服务端通信实现、连接稳定性优化、消息队列集成及高并发处理策略。通过完整案例,帮助开发者构建高效稳定的实时通信系统,适用于聊天应用、实时数据推送等场景。

5

2026.03.18

Java Spring Security权限控制与认证机制实战
Java Spring Security权限控制与认证机制实战

本专题围绕 Java 后端安全体系建设展开,重点讲解 Spring Security 在权限控制与认证机制中的应用实践。内容涵盖用户认证流程、权限模型设计、JWT 鉴权方案、OAuth2 集成以及接口安全防护策略。通过实际项目案例,帮助开发者构建安全可靠的后端认证体系,提升系统安全性与可扩展能力。

21

2026.03.18

抖漫入口地址合集
抖漫入口地址合集

本专题整合了抖漫入口地址相关合集,阅读专题下面的文章了解更多详细地址。

138

2026.03.17

多环境下的 Nginx 安装、结构与运维实战
多环境下的 Nginx 安装、结构与运维实战

本专题聚焦多环境下Nginx实战,详解开发、测试及生产环境的差异化安装策略与目录结构规划。深入剖析配置模块化设计、灰度发布流程及跨环境同步机制。结合监控告警、故障排查与自动化运维工具,提供全链路管理方案,助力团队构建灵活、高可用的Nginx服务体系,从容应对复杂业务场景挑战。

14

2026.03.17

PS 批量添加图片
PS 批量添加图片

本专题整合了PS批量添加图片教程合集,阅读专题下面的文章了解更多详细操作。

15

2026.03.17

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
最新Python教程 从入门到精通
最新Python教程 从入门到精通

共4课时 | 22.5万人学习

Django 教程
Django 教程

共28课时 | 5.1万人学习

SciPy 教程
SciPy 教程

共10课时 | 2万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号