Python核心库Literal的具体使用
更新时间：2026年02月05日 10:01:16 作者：user5838167523996
Literal是Python 3.8+中引入的类型提示工具,用于精确指定变量或函数参数的值,它在函数签名中非常有用,可以在编写代码时提前发现错误,下面就来介绍一下具体使用
from typing import Literal 是 Python 3.8+ 的标准库导入，它引入了一个“字面量类型”（Literal）的概念，用来把类型检查精确到具体的值，而不仅仅是“str / int / bool”这类宽泛类型。
1.基础语法
from typing import Literal Mode = Literal["auto", "none", "required"] # 变量 Mode 只能是字符串 "auto"、"none" 或 "required"，传别的值就报错。
2.在函数签名里怎么用
def set_tool_choice(mode: Literal["auto", "none", "required"]) -> None:
...
set_tool_choice("auto") # ✅ 通过
set_tool_choice("required") # ✅ 通过
set_tool_choice("REQUIRED") # ❌ 大小写不一致，静态检查器会标红
3.运行时行动
Literal 本身不会在运行时拦截非法值；它的威力体现在写代码阶段就能发现拼写错误、避免“魔法字符串”满天飞。
如果你需要运行期也校验，可以搭配 pydantic 或 enum：
from pydantic import BaseModel, Field
class Request(BaseModel):
tool_choice: Literal["auto", "none", "required"] = "auto"
4.与 Union 区别
# 旧写法，宽泛 Mode = Union[str, int] # 任何 str / int 都合法 # 新写法，精确 Mode = Literal["auto", "none", "required"] # 只有这三个字符串合法
一句话总结
Literal 就是“把允许的值写进类型系统”，让 IDE 和静态检查器帮你提前发现手滑拼错、传错参数，写接口、写配置枚举时特别香。
到此这篇关于Python核心库Literal的具体使用的文章就介绍到这了,更多相关Python核心库Literal内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！
相关文章
这篇文章主要介绍了基于python实现自动发送邮件教程解析,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下2020-06-06
这篇文章主要介绍了我如何用python写颜值评分器，本文给大家介绍的非常详细，对大家的学习或工作具有一定的参考借鉴价值，需要的朋友可以参考下2021-08-08
python实现单目标、多目标、多尺度、自定义特征的KCF跟踪算法(实例代码)
这篇文章主要介绍了python实现单目标、多目标、多尺度、自定义特征的KCF跟踪算法,本文通过实例代码给大家介绍的非常详细，具有一定的参考借鉴价值，需要的朋友可以参考下2020-01-01
今天小编就为大家分享一篇tensorflow 变长序列存储实例，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧2020-01-01
随着音频数据量的不断增长,传统的单机处理方式已经难以满足大规模音频处理的需求,分布式处理技术通过将任务分解并分配到多个计算节点上,可以显著提高处理速度和效率,本文将深入探讨如何使用Python实现音频文件的分布式处理,需要的朋友可以参考下2025-12-12
这篇文章主要为大家详细介绍了Python实现网站注册验证码生成类，具有一定的参考价值，感兴趣的小伙伴们可以参考一下2017-06-06
数据预处理在解决深度学习问题的过程中,往往需要花费大量的时间和精力,下面这篇文章主要给大家介绍了关于pytorch加载自己的图片数据集的2种方法,文中通过示例代码介绍的非常详细,需要的朋友可以参考下2022-06-06
这篇文章主要为大家详细介绍了如何使用python实现读取本地OUTLOOK客户端邮件,文中的示例代码讲解详细,具有一定的参考价值,需要的小伙伴可以了解下2023-10-10
python 如何把classification_report输出到csv文件
这篇文章主要介绍了python 把classification_report输出到csv文件的操作，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教2021-05-05
python常用时间库time、datetime与时间格式之间的转换教程
Python项目中很多时候会需要将时间在Datetime格式和TimeStamp格式之间转化,下面这篇文章主要给大家介绍了关于python常用时间库time、datetime与时间格式之间转换的相关资料,需要的朋友可以参考下2023-02-02
最新评论