python高级模块包之typing

目录

前言

1、typing是干什么的？

2、typing模块的作用：

3、typing中各种数据类型的使用

3.1 最简单的 int、str、LIst、Dict

3.2 Dict、Tuple、Sequece，Mapping

3.3 Callable

3.4 标记自定义的

3.5 泛型

3.5.1 泛型在函数中的使用方法

3.5.2 自定义的泛型类

---

前言

最近在项目中使用fastapi框架编写后台接口时，用到了schema，而schema是用pydantic来进行验证的。pydantic中的数据验证使用到了typing中的很多模块，因此开始注意到这个typing。在网上查资料，并没有太多有价值的信息，基本上都是从python document中复制粘贴过来的。

让人恼火的是，python document 对于 typing这个模块的使用的讲解，让人很难懂。因此特写此文，结合自己使用上的理解，来记录一下typing模块到底是怎么使用的。

在typing模块的意义上，python document的介绍还是很清晰的，建议大家去看一下 PEP 484 -- Type Hints，这里面介绍的typing的由来，以及typing出现前，大家是怎样通过注释来解决注释的问题的，以及python这个动态语言为什么需要typing等等内容。相信看完后，可以让大家非常深刻理解 typing出现的意义是什么。下面附上链接：
https://www.python.org/dev/peps/pep-0484/#abstract

这篇文章我会基于 python document中的给出的例子，着重分析每一个例子是什么意思，比如说官网给出的泛型的定义方法，但是没有说明是怎样去使用的，而这篇文章就是对其的一个补充，详细的讲怎么用。

 

1、typing是干什么的？

这个话题，如果大家有时间，建议还是去看 PEP 484 ，会给你讲  typing的前生今世，非常好的内容。如果没时间，或者图省事，那就看我下面的介绍吧。

首先，Python是解释型语言，不会在程序执行前对代码进行检查。python又是动态语言，动态类型带来的直观表现有两点。第一，在创建变量时无需指定数据类型；第二，可以将不同类型的值赋给同一变量。

我们知道，项目变大变复杂的时候，动态类型的缺点就会变得明显，没有完善的代码提示，代码可读性差等缺点会使代码维护变得困难。

很多人在写完代码一段时间后回过头看代码，很可能忘记了自己写的函数需要传什么参数，返回什么类型的结果，就不得不去阅读代码的具体内容，降低了阅读的速度，加上Python本身就是一门弱类型的语言，这种现象就变得更加的严重，而typing这个模块很好的解决了这个问题。

 

2、typing模块的作用：

1、类型检查，防止运行时出现参数和返回值类型不符合。

2、作为开发文档附加说明，方便使用者调用时传入和返回参数类型。

3、该模块加入后并不会影响程序的运行，不会报正式的错误，只有提醒。

4、IDE可以提供更精准的代码提示，提高开发效率

在pycharm中是集成支持typing的，我们测试一下，看看自动提示的效果，见下图

我们可以看到，当我对stu标记为一个list变量时，弱传参时不是list类型时，IDE会提示

注意：typing模块只有在python3.5以上的版本中才可以使用

 

3、typing中各种数据类型的使用