讲师中心 微信公众号
AI工具推荐 视频效率加速

Python数据校验模型教程_dataclass基础用法

浅辰酱_2506

浅辰酱_2506

发布时间:2026-01-11 16:11:02

|

459人浏览过

|

来源于php中文网

原创

dataclass本身不校验,需配合__post_init__或pydantic实现:前者适合轻量规则校验,后者支持强类型、默认值、嵌套等完整能力。

python数据校验模型教程_dataclass基础用法

Python 中用 dataclass 做数据校验,核心不是它本身——@dataclass 默认不校验,得靠类型提示 + 第三方库(比如 pydantic)或手动加 __post_init__。但它是构建可校验模型的绝佳起点:结构清晰、字段明确、初始化自动,天然适配校验逻辑。

用 @dataclass 定义基础结构

先写一个干净的数据容器,明确字段名和类型:

from dataclasses import dataclass
<p>@dataclass
class User:
name: str
age: int
email: str

这样就自动生成了 __init__、__repr__ 和 __eq__。但注意:此时传入 age="abc" 不会报错,因为 Python 运行时不检查类型。

加类型校验:用 __post_init__ 手动把关

在实例创建后立刻验证字段值,适合轻量级业务规则:

立即学习“Python免费学习笔记(深入)”;

  • 检查 age 是否为正整数
  • 确认 email 包含 @
  • 对空字符串或 None 提前拦截

示例:

@dataclass
class User:
    name: str
    age: int
    email: str
<pre class="brush:php;toolbar:false;">def __post_init__(self):
    if not isinstance(self.age, int) or self.age < 0:
        raise ValueError("age must be a non-negative integer")
    if "@" not in self.email:
        raise ValueError("email must contain '@'")
    if not self.name or not isinstance(self.name, str):
        raise ValueError("name must be a non-empty string")

macOS UI 自动化技能包 —— 用 Python 控制你的 Mac
macOS UI 自动化技能包 —— 用 Python 控制你的 Mac

让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac,无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启:辅助功能 + 屏幕录制权限

下载

配合 pydantic 实现强校验(推荐)

如果需要完整类型校验、默认值、嵌套模型、JSON 序列化等能力,直接用 pydantic.BaseModel 更省心。但它底层常和 dataclass 思路一致,且支持 @dataclass 风格写法(v2+):

from pydantic.dataclasses import dataclass
<p>@dataclass
class User:
name: str
age: int
email: str</p><pre class="brush:php;toolbar:false;">def __post_init_post_parse__(self):
    # 解析后额外校验(类似 __post_init__)
    if self.age < 0:
        raise ValueError("age cannot be negative")

这时传入 age="25" 会自动转成 int;传入 age=-5 则触发异常。

字段默认值与可选字段处理

校验常涉及“字段是否必填”。用 field(default=...) 或 Optional 明确语义:

  • score: float = 0.0 → 有默认值,不传也不报错
  • tags: list[str] = field(default_factory=list) → 可变默认值安全写法
  • phone: Optional[str] = None → 允许为空,校验时需单独判断是否提供

注意:不要用 list 或 dict 直接作默认值,会共享引用。

不复杂但容易忽略:dataclass 是骨架,校验是肌肉;光有类型注解不够,得靠运行时逻辑或专用工具来发力。

热门AI工具

更多
二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

小橡皮AI

一款AI工具,主要用于小橡皮一键去AI味,将机器味重的内容改得更有活人感,防止因为 AI 内容被平台打上 AI 标签,以及限流,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

2195

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

3462

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

1156

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

3979

2025.09.10

css中float用法
css中float用法

css中float属性允许元素脱离文档流并沿其父元素边缘排列,用于创建并排列、对齐文本图像、浮动菜单边栏和重叠元素。想了解更多float的相关内容,可以阅读本专题下面的文章。

6967

2024.04.28

C++中int、float和double的区别
C++中int、float和double的区别

本专题整合了c++中int和double的区别,阅读专题下面的文章了解更多详细内容。

804

2025.10.23

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

1818

2023.08.03

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

2864

2023.09.04

Vite 项目如何打包和部署
Vite 项目如何打包和部署

Vite项目打包部署专题汇集生产构建、产物预览、输出目录、资源路径、Nginx与GitHub Pages部署及常见白屏和路由404问题的已审核文章,帮助读者完成上线流程。

20

2026.10.28

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Uvicorn官方安装与入门手册
Uvicorn官方安装与入门手册

共0课时 | 0人学习

Python uv官方项目管理指南
Python uv官方项目管理指南

共0课时 | 0人学习

Python uv官方安装与入门文档
Python uv官方安装与入门文档

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn