4 个早该掌握的 Python 类型注解技巧
off999 2025-08-05 20:30 58 浏览 0 评论
在 Python 的开发过程中，类型注解常常被忽视。但当面对一段缺乏类型提示、逻辑复杂的代码时，理解和维护成本会迅速上升，极易陷入“阅读地狱”。
本文整理了 4 个关于 Python 类型注解的重要技巧，能显著提升代码的可读性、灵活性与可维护性，值得每一位 Python 开发者掌握。
1. 参数用泛型，返回值用具体类型
很多人写函数时参数和返回值都用具体类型，比如 list[int]。这其实会造成灵活性降低，因为调用者就必须传入一个列表，而无法传入元组、字典的 key 等“类列表”对象。
正确的做法是：
- 对函数参数使用泛型类型（如 Sequence[int]），让函数更灵活；
- 对函数返回值使用具体类型（如 list[int]），表达你的函数明确会返回什么。
这样的注解方式更加合理、清晰。
2. List[], Dict[]等已被弃用
在旧代码中你可能见过这样的写法：
但从 Python 3.9 开始，这些写法已经被弃用。我们可以直接使用内建类型来进行注解，例如：
不仅更简洁，也可以省去额外的 typing 导入。
3. 给元组做类型注解的方式不同
很多人以为 tuple[int, str, float] 表示一个“元素类型是 int、str、float 的元组”，但实际上，它表示的是一个长度为 3 的元组，并且：
- 第一个元素是 int
- 第二个元素是 str
- 第三个元素是 float
注意：这和 list[int]（表示任意长度、每个元素是 int 的列表）是不一样的。
如果你需要表示“任意长度、每个元素都是某类型”的元组，可以用 tuple[int, ...]。
4. 用 NamedTuple提升可读性
如果你用一个元组来表示某种结构化的数据，就算你注解为 tuple[str, int, str]，也没法让人一眼看出每个字段代表什么。此时就推荐使用 NamedTuple，为每个字段命名。
这不仅能提升可读性，还可以用属性名来访问字段，使代码更加清晰明了。
类型注解不只是为了类型检查，更是提升代码可读性、维护性的重要手段。掌握这些技巧，可以让你写出更专业、更易读的 Python 代码：
- 参数泛型、返回值具体
- 使用内建类型代替 List[], Dict[]
- 理解 tuple 注解的语义
- 用 NamedTuple 替代“匿名元组”
欢迎把这篇文章分享给还在“苦读无类型注解代码”的朋友们～
相关推荐
- apisix动态修改路由的原理_动态路由协议rip的配置
-
ApacheAPISIX能够实现动态修改路由（DynamicRouting）的核心原理，是它将传统的静态Nginx配置彻底解耦，通过中心化配置存储（如etcd）+OpenRest...
- 使用 Docker 部署 OpenResty Manager 搭建可视化反向代理系统
-
在之前的文章中，xiaoz推荐过可视化Nginx反向代理工具NginxProxyManager，最近xiaoz还发现一款功能更加强大，界面更加漂亮的OpenRestyManager，完全可以替代...
- OpenResty 入门指南:从基础到动态路由实战
-
一、引言1.1OpenResty简介OpenResty是一款基于Nginx的高性能Web平台，通过集成Lua脚本和丰富的模块，将Nginx从静态反向代理转变为可动态编程的应用平台...
- OpenResty 的 Lua 动态能力_openresty 动态upstream
-
OpenResty的Lua动态能力是其最核心的优势，它将LuaJIT嵌入到Nginx的每一个请求处理阶段，使得开发者可以用Lua脚本动态控制请求的生命周期，而无需重新编译或rel...
- LVS和Nginx_lvs和nginx的区别
-
LVS（LinuxVirtualServer）和Nginx都是常用的负载均衡解决方案，广泛应用于大型网站和分布式系统中，以提高系统的性能、可用性和可扩展性。一、基本概念1.LVS（Linux...
- 外网连接到内网服务器需要端口映射吗，如何操作?
-
外网访问内网服务器通常需要端口映射（或内网穿透），这是跨越公网与私网边界的关键技术。操作方式取决于网络环境，以下分场景详解。一、端口映射的核心原理内网服务器位于私有IP地址段（如192.168.x.x...
- Nginx如何解决C10K问题(1万个并发连接)?
-
关注△mikechen△，十余年BAT架构经验倾囊相授！大家好，我是mikechen。Nginx是大型架构的必备中间件，下面我就全面来详解NginxC10k问题@mikechen文章来源：mikec...
- 炸场!Spring Boot 9 大内置过滤器实战手册:从坑到神
-
炸场！SpringBoot9大内置过滤器实战手册：从坑到神在Java开发圈摸爬滚打十年，见过太多团队重复造轮子——明明SpringBoot自带的过滤器就能解决的问题，偏偏要手写几十...
- WordPress和Typecho xmlrpc漏洞_wordpress主题漏洞
-
一般大家都关注WordPress，毕竟用户量巨大，而国内的Typecho作为轻量级的博客系统就关注的人并不多。Typecho有很多借鉴WordPress的，包括兼容的xmlrpc接口，而WordPre...
- Linux Shell 入门教程(六):重定向、管道与命令替换
-
在前几篇中，我们学习了函数、流程控制等Shell编程的基础内容。现在我们来探索更高级的功能：如何控制数据流向、将命令链接在一起、让命令间通信变得可能。一、输入输出重定向（>、>>...
- Nginx的location匹配规则，90%的人都没完全搞懂，一张图让你秒懂
-
刚配完nginx网站就崩了？运维和开发都头疼的location匹配规则优先级，弄错顺序直接导致500错误。核心在于nginx处理location时顺序严格：先精确匹配=，然后前缀匹配^~，接着按顺序正...
- liunx服务器查看故障命令有那些?_linux查看服务器性能命令
-
在Linux服务器上排查故障时，需要使用一系列命令来检查系统状态、日志文件、资源利用情况以及网络状况。以下是常用的故障排查命令，按照不同场景分类说明。1.系统资源相关命令1.1查看CPU使...
- 服务器被入侵的常见迹象有哪些?_服务器入侵可以被完全操纵吗
-
服务器被入侵可能会导致数据泄露、服务异常或完全失控。及时发现入侵迹象能够帮助你尽早采取措施，减少损失。以下是服务器被入侵的常见迹象以及相关的分析与处理建议。1.服务器被入侵的常见迹象1.1系统性能...
- 前端错误可观测最佳实践_前端错误提示
-
场景解析对于前端项目，生产环境的代码通常经过压缩、混淆和打包处理，当代码在运行过程中产生错误时，通常难以还原原始代码从而定位问题，对于深度混淆尤其如此，因此Mozilla自2011年开始发起并...
- 8个能让你的Kubernetes集群“瞬间崩溃”的配置错误
-
错误一：livenessProbe探针“自杀式”配置——30秒内让Pod重启20次现象：Pod状态在Running→Terminating→CrashLoopBackOff之间循环，重启间隔仅...
欢迎 你 发表评论:
- 一周热门
- 最近发表
-
- apisix动态修改路由的原理_动态路由协议rip的配置
- 使用 Docker 部署 OpenResty Manager 搭建可视化反向代理系统
- OpenResty 入门指南:从基础到动态路由实战
- OpenResty 的 Lua 动态能力_openresty 动态upstream
- LVS和Nginx_lvs和nginx的区别
- 外网连接到内网服务器需要端口映射吗，如何操作?
- Nginx如何解决C10K问题(1万个并发连接)?
- 炸场!Spring Boot 9 大内置过滤器实战手册:从坑到神
- WordPress和Typecho xmlrpc漏洞_wordpress主题漏洞
- Linux Shell 入门教程(六):重定向、管道与命令替换
- 标签列表
-
- python计时 (73)
- python安装路径 (56)
- python类型转换 (93)
- python进度条 (67)
- python吧 (67)
- python的for循环 (65)
- python格式化字符串 (61)
- python静态方法 (57)
- python列表切片 (59)
- python面向对象编程 (60)
- python 代码加密 (65)
- python串口编程 (77)
- python封装 (57)
- python写入txt (66)
- python读取文件夹下所有文件 (59)
- python操作mysql数据库 (66)
- python获取列表的长度 (64)
- python接口 (63)
- python调用函数 (57)
- python多态 (60)
- python匿名函数 (59)
- python打印九九乘法表 (65)
- python赋值 (62)
- python异常 (69)
- python元祖 (57)