4 个早该掌握的 Python 类型注解技巧
off999 2025-08-05 20:30 3 浏览 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 替代“匿名元组”
欢迎把这篇文章分享给还在“苦读无类型注解代码”的朋友们～
相关推荐
- Python函数参数和返回值类型:让你的代码更清晰、更健壮
-
在Python开发中，你是否遇到过这些抓狂时刻？同事写的函数参数类型全靠猜调试两小时发现传了字符串给数值计算函数重构代码时不知道函数返回的是列表还是字典今天教你两招，彻底解决类型混乱问题！让你的...
- 有公司内部竟然禁用了python开发，软件开发何去何从?
-
今天有网友在某社交平台发文：有公司内部竟然禁止了python开发！帖子没几行，评论却炸锅了。有的说“太正常，Python本就不适合做大项目”，还有的反驳“飞书全员用Python”。暂且不说这家公司...
- 写 Python 七年才发现的七件事:真正提高生产力的脚本思路
-
如果你已经用Python写了不少脚本，却总觉得代码只是“能跑”，这篇文章或许会刷新你对这门语言的认知。以下七个思路全部来自一线实战，没有花哨的概念，只有可落地的工具与习惯。它们曾帮我省下大量无意义...
- 用Python写一个A*搜索算法含注释说明
-
大家好！我是幻化意识流。今天我们用Python写一个A*搜索算法的代码，我做了注释说明，欢迎大家一起学习：importheapq#定义搜索节点类，包括当前状态、从初始状态到该状态的代价g、从该状态...
- 使用python制作一个贪吃蛇游戏,并为每一句添加注释方便学习
-
今天来设计一个贪吃蛇的经典小游戏。先介绍下核心代码功能（源代码请往最后面拉）：游戏功能：-四个难度等级：简单(8FPS)、中等(12FPS)、困难(18FPS)、专家(25FPS)-美...
- Python 之父 Guido van Rossum 宣布退休
-
Python之父GuidovanRossum在推特公布了自己从Dropbox公司离职的消息，并表示已经退休。他还提到自己在Dropbox担任工程师期间学到了很多东西——Python的类型注解（T...
- 4 个早该掌握的 Python 类型注解技巧
-
在Python的开发过程中，类型注解常常被忽视。但当面对一段缺乏类型提示、逻辑复杂的代码时，理解和维护成本会迅速上升，极易陷入“阅读地狱”。本文整理了4个关于Python类型注解的重要技巧...
- 让你的Python代码更易读:7个提升函数可读性的实用技巧
-
如果你正在阅读这篇文章，很可能你已经用Python编程有一段时间了。今天，让我们聊聊可以提升你编程水平的一件事：编写易读的函数。请想一想：我们花在阅读代码上的时间大约是写代码的10倍。所以，每当你创建...
- Python异常模块和包
-
异常当检测到一个错误时，Python解释器就无法继续执行了，反而出现了一些错误的提示，这就是所谓的“异常”,也就是我们常说的BUG例如：以`r`方式打开一个不存在的文件。f=open('...
- 别再被 return 坑了!一文吃透 Python return 语句常见错误与调试方法
-
Pythonreturn语句常见错误与调试方法（结构化详解）一.语法错误：遗漏return或返回值类型错误错误场景pythondefadd(a,b):print(a+b)...
- Python数据校验不再难:Pydantic库的工程化实践指南
-
在FastAPI框架横扫Python后端开发领域的今天，其默认集成的Pydantic库正成为处理数据验证的黄金标准。这个看似简单的库究竟隐藏着哪些让开发者爱不释手的能力？本文将通过真实项目案例，带您解...
- python防诈骗的脚本带注释信息
-
以下是一个简单但功能完整的防诈骗脚本，包含URL检测、文本分析和风险评估功能。代码结构清晰，带有详细注释，适合作为个人或家庭防诈骗工具使用。这个脚本具有以下功能：文本诈骗风险分析：检测常见诈骗关键...
- Python判断语句
-
布尔类型和比较运算符布尔类型的定义：布尔类型只有两个值：True和False可以通过定义变量存储布尔类型数据：变量名称=布尔类型值（True/False）布尔类型不仅可以自行定义，同时也可通过...
- 使用python编写俄罗斯方块小游戏并为每一句添加注释，方便学习
-
先看下学习指导#俄罗斯方块游戏开发-Python学习指导##项目概述这个俄罗斯方块游戏是一个完整的Python项目，涵盖了以下重要的编程概念：-面向对象编程（OOP）-游戏开发基础-数据...
- Python十大技巧:不掌握这些，你可能一直在做无用功!
-
在编程的世界里，掌握一门语言只是起点，如何写出优雅、高效的代码才是真功夫。Python作为最受欢迎的编程语言之一，拥有简洁明了的语法，但要想真正精通这门语言，还需要掌握一些实用的高级技巧。一、列表推导...
欢迎 你 发表评论:
- 一周热门
- 最近发表
- 标签列表
-
- 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读取文件夹下所有文件 (59)
- java调用python脚本 (56)
- python操作mysql数据库 (66)
- python获取列表的长度 (64)
- python接口 (63)
- python调用函数 (57)
- python多态 (60)
- python匿名函数 (59)
- python打印九九乘法表 (65)
- python赋值 (62)
- python异常 (69)
- python元祖 (57)