Python 的类型注解(Type Hint)语法(:)

张开发
2026/5/5 7:26:34 15 分钟阅读
Python 的类型注解(Type Hint)语法(:)
文章目录 这行代码拆开看 冒号的作用是什么 翻译成人话 再拆一下结构 举几个简单例子你就彻底懂了1️⃣ 基础类型2️⃣ 列表类型3️⃣ 你的这个例子❗ 一个非常重要的点也就是说 那为什么要写主要作用✅ 1提高可读性✅ 2IDE 提示你现在看到的那种✅ 3静态检查mypy / pyright 用一句话总结 再补一个进阶点你以后一定会遇到 总结这个“冒号”其实是Python 的类型注解Type Hint语法我给你讲清楚 这行代码拆开看split_document:list[Document]self.spliter.split_documents(documents) 冒号的作用是什么 这个冒号:表示给变量标注“类型” 翻译成人话这行代码等价于split_document 是一个 list里面的元素是 Document 再拆一下结构部分含义split_document变量名:类型声明list[Document]类型列表里面是 Document赋值self.spliter.split_documents(...)实际返回值 举几个简单例子你就彻底懂了1️⃣ 基础类型x:int10name:strethan 表示x 是整数name 是字符串2️⃣ 列表类型nums:list[int][1,2,3] 表示一个“整数列表”3️⃣ 你的这个例子split_document:list[Document] 表示一个“Document对象的列表”❗ 一个非常重要的点 这个类型注解不会影响代码运行也就是说这两行是一样的split_documentself.spliter.split_documents(documents)split_document:list[Document]self.spliter.split_documents(documents) 那为什么要写主要作用✅ 1提高可读性别人一看就知道这个变量是 Document 列表✅ 2IDE 提示你现在看到的那种自动补全类型检查✅ 3静态检查mypy / pyright提前发现错误 用一句话总结:在这里不是“语法必须”而是“给变量加说明书类型提示” 再补一个进阶点你以后一定会遇到函数里也会这样写defsplit_documents(self,documents:list[Document])-list[Document]: 含义输入Document列表输出Document列表 总结变量: 类型 值 表示“这个变量应该是什么类型”但不影响运行

更多文章