企业官网建设流程全解析

百度云图片转wordpress,wordpress seo怎么做,常州市住房建设局网站,个人如何开发微信小程序TypedDict 是 Python 3.8 引入的类型提示工具#xff08;位于 typing 模块#xff0c;Python 3.9 可直接在 dict 上使用泛型语法#xff09;#xff0c;用于为字典#xff08;dict#xff09;指定固定键名和对应值类型#xff0c;解决了普通字典“键名不固定、值类型模糊…TypedDict是 Python 3.8 引入的类型提示工具位于typing模块Python 3.9 可直接在dict上使用泛型语法用于为字典dict指定固定键名和对应值类型解决了普通字典“键名不固定、值类型模糊”的类型提示问题让代码更易读、更易维护且能被类型检查工具如mypy、PyCharm 内置检查验证。一、核心作用给字典“定规矩”普通字典的类型提示如dict[str, int]只能说明“键是字符串、值是整数”但无法限制必须有哪些键、不能有哪些额外键。而TypedDict可以明确字典必须包含哪些键每个键对应的值必须是什么类型可选键非必需和必填键的区分。示例对比# 普通字典只能知道键是 str、值是 int但不知道具体有哪些键defprocess_user(user:dict[str,int])-None:print(user[id])# 不确定 user 是否有 id 键可能运行时出错print(user[age])# 同样存在键缺失风险# TypedDict明确指定键名和类型类型检查工具会提前报错fromtypingimportTypedDictclassUser(TypedDict):id:int# 必填键age:int# 必填键name:str# 必填键email:str|None# 可选类型值可以是 str 或 Nonedefprocess_user(user:User)-None:print(user[id])# 安全User 一定有 id 键且类型是 intprint(user[email])# 安全类型是 str | None不会误判类型二、基本用法1. 定义TypedDict两种方式方式1类继承TypedDict推荐可读性强fromtypingimportTypedDict# 定义一个表示“书籍”的 TypedDictclassBook(TypedDict):title:str# 书名字符串必填author:str# 作者字符串必填pages:int# 页数整数必填price:float# 价格浮点数必填is_published:bool# 是否出版布尔值必填方式2函数式定义适用于简单场景fromtypingimportTypedDict# 格式TypedDict(名称, {键名: 类型, ...})BookTypedDict(Book,{title:str,author:str,pages:int,price:float,is_published:bool})2. 可选键非必需键用Optional或| NonePython 3.10表示“值可以是该类型或 None”但如果要表示“键本身可选”需用totalFalse或Required/NotRequiredPython 3.11 推荐。方法1全局totalFalse所有键默认可选classBook(TypedDict,totalFalse):# totalFalse所有键都是可选的title:strauthor:strpages:int# 合法可以只传部分键book1:Book{title:Python 编程}book2:Book{author:张三,pages:300}方法2Required/NotRequiredPython 3.11精准控制单个键更灵活可混合必填和可选键fromtypingimportTypedDict,Required,NotRequiredclassBook(TypedDict):title:Required[str]# 明确必填author:Required[str]# 明确必填pages:NotRequired[int]# 明确可选可省略该键price:NotRequired[float]# 合法必填键齐全可选键可省book:Book{title:Python 编程,author:张三}# 合法包含可选键book2:Book{title:Java 编程,author:李四,pages:400,price:59.9}# 不合法类型检查报错缺少必填键 authorbook3:Book{title:C 编程}3. 使用TypedDict实例TypedDict仅用于类型提示运行时不会强制检查Python 是动态类型语言但类型检查工具如mypy会提前拦截错误# 正确实例符合 Book 的键名和类型valid_book:Book{title:IPython 教程,author:开发者,pages:200,price:49.9,is_published:True}# 错误实例1键类型不匹配price 应为 float传了 intinvalid_book1:Book{title:IPython 教程,author:开发者,pages:200,price:49,# 类型检查报错expected float, got intis_published:True}# 错误实例2缺少必填键authorinvalid_book2:Book{title:IPython 教程,pages:200,price:49.9,is_published:True}# 类型检查报错missing required key author# 错误实例3额外键不允许未定义的键除非用 totalFalse 且不限制invalid_book3:Book{title:IPython 教程,author:开发者,pages:200,price:49.9,is_published:True,publisher:出版社# 类型检查报错unexpected key publisher}三、高级用法1. 继承TypedDict扩展已有结构可以像普通类一样继承TypedDict实现结构复用fromtypingimportTypedDictclassBaseUser(TypedDict):id:intname:str# 继承 BaseUser新增字段classAdminUser(BaseUser):permissions:list[str]# 管理员额外的“权限列表”字段department:str# 部门字段# 合法包含 BaseUser 的所有键 AdminUser 的新增键admin:AdminUser{id:1,name:管理员,permissions:[delete,edit],department:技术部}2. 嵌套TypedDict复杂结构当字典的值是另一个字典时可嵌套TypedDict实现多层类型提示fromtypingimportTypedDictclassAddress(TypedDict):city:strstreet:strzipcode:strclassUser(TypedDict):id:intname:straddress:Address# 嵌套 Address 类型# 合法address 字段符合 Address 的结构user:User{id:2,name:用户,address:{city:北京,street:中关村大街,zipcode:100080}}3. 与Union结合多类型可选允许某个键的值是多种类型用Union或|Python 3.10fromtypingimportTypedDict,UnionclassProduct(TypedDict):id:intname:strprice:Union[int,float]# 价格可以是 int 或 floatPython 3.10 可写 int | float# 两种价格类型都合法product1:Product{id:1,name:手机,price:2999}# int 价格product2:Product{id:2,name:耳机,price:199.9}# float 价格4. Python 3.9 泛型语法dict直接指定结构Python 3.9 引入了dict的泛型语法可直接用dict[TypedDict]简化写法无需显式继承TypedDict# Python 3.9 支持fromtypingimportTypedDictclassUser(TypedDict):id:intname:str# 等同于 User 类型user:dict[str,int|str]# 普通泛型不限制键名user2:User# TypedDict限制键名和对应类型四、TypedDict的注意事项仅用于类型提示运行时不校验Python 解释器不会在运行时检查字典是否符合TypedDict定义比如少传键、类型不匹配不会报错需配合mypy等工具做静态类型检查。# 安装 mypy 后检查文件mypy your_script.py键名必须是字符串常量TypedDict的键只能是字符串不能是变量、表达式且定义时必须明确键名。与NamedTuple的区别TypedDict本质是字典dict实例支持动态修改键值但不建议修改结构NamedTuple本质是元组tuple实例不可变更适合“固定结构、不修改”的场景。total参数的默认值默认totalTrue即所有键都是必填的totalFalse时所有键都是可选的可省略。五、应用场景接口数据校验前后端交互、API 响应数据的结构提示比如明确接口返回的字典必须包含code、message、data键且类型固定。配置文件解析配置字典的键名和类型固定比如数据库配置db_config必须包含host、port、user、password。函数参数/返回值提示明确函数接收的字典参数结构或函数返回的字典结构减少文档注释提升代码可读性。示例API 响应数据fromtypingimportTypedDict,Optional,ListclassUserData(TypedDict):id:intname:strage:Optional[int]classApiResponse(TypedDict):code:intmessage:strdata:Optional[List[UserData]]# data 是 UserData 列表或 None# 函数返回值类型提示明确 API 响应结构deffetch_users()-ApiResponse:return{code:200,message:success,data:[{id:1,name:张三,age:25},{id:2,name:李四,age:None}]}总结TypedDict是 Python 中给字典“结构化”的核心工具通过明确键名和对应值类型解决了普通字典类型提示模糊的问题。它不影响运行时性能仅用于静态类型检查能显著提升代码的可读性、可维护性尤其适合数据交互、配置解析等字典结构固定的场景。如果你的项目使用 Python 3.8且需要处理大量结构化字典数据TypedDict是比普通dict类型提示更优的选择。