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

Python attrs 库简化数据对象的思路

阿晨大大_9840

阿晨大大_9840

发布时间:2026-02-18 15:56:30

|

836人浏览过

|

来源于php中文网

原创

因为 attrs 支持字段级延迟默认值、更细粒度冻结控制、原生 __attrs_post_init__ 钩子,且兼容 Python 3.5;dataclass 在 __post_init__ 中无法安全访问其他字段,字段控制语法也更冗长。

python attrs 库简化数据对象的思路

为什么不用 dataclass 而选 attrs

因为 attrs 在 Python 3.6+ 里能做 dataclass 做不了的事:比如字段级默认值延迟计算、更细粒度的冻结控制、原生支持 __attrs_post_init__ 钩子,且对旧版 Python(如 3.5)仍有支持。如果你项目还在用 3.5 或需要字段初始化后立刻校验/转换,attrs 是更稳的选择。

常见错误现象:dataclass 里写 field(default_factory=lambda: []) 看似可行,但无法在 __post_init__ 中安全访问其他字段——而 attrs 的 __attrs_post_init__ 总能拿到完整实例状态。

  • attrs 默认不生成 __init__ 的字段(如 attr.ib(init=False)),dataclass 必须靠 field(init=False),语义一致但写法略冗
  • 想让某个字段只参与比较不参与哈希?eq=True, hash=False 直接配,dataclass 得靠 field(compare=True, hash=False)
  • attrs 的 convert 和 validator 是声明式内建能力,不用手动塞进 __post_init__

attr.ib 的常用参数组合怎么选

别一上来就全用默认值。字段行为差异主要来自这四个参数的搭配:

  • default=...:静态值,比如 default=None;动态值必须用 factory,比如 factory=list(注意不是 factory=lambda: [],后者每次调用都新建 lambda 对象)
  • converter=...:接收原始输入并转成目标类型,比如 converter=str 或自定义函数,失败抛 ValueError,它在 validator 之前执行
  • validator=...:只校验,不改值,比如 attr.validators.instance_of(int),多个校验器用 attr.validators.and_(...) 组合
  • kw_only=True:强制该字段只能用关键字传参,适合可选配置项,避免位置参数错位

性能影响:所有 converter / validator 都在实例化时同步执行,高频创建对象时要注意函数开销;validator 不触发属性访问,所以不会意外触发 descriptor 的 __get__。

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

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

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

下载

冻结对象后还能改字段吗

能,但得绕过保护机制——这不是 bug,是设计如此:frozen=True 只禁用常规赋值(obj.x = 1),不拦 object.__setattr__(obj, 'x', 1)。所以“冻结”本质是防误改,不是绝对不可变。

容易踩的坑:

  • 用了 frozen=True 却在 __attrs_post_init__ 里直接赋值字段,会报 FrozenInstanceError;正确做法是先调 object.__setattr__(self, 'x', value)
  • 继承自 frozen 类的子类,如果没显式写 frozen=True,子类实例反而可修改父类字段——冻结不自动继承
  • attrs 的 evolve() 函数能安全复制并修改字段,比手动绕过 __setattr__ 更推荐

和 Pydantic v2 混用时字段校验谁生效

如果你把 attrs 类当 Pydantic 的 model_config = {'arbitrary_types_allowed': True} 里的字段类型用,校验链是:Pydantic 先走自己的验证逻辑(比如 str 转换、@field_validator),再把结果传给 attrs 实例化——此时 attrs 的 converter 和 validator 仍会执行。

这意味着:

  • 重复校验可能触发两次异常,堆栈难读;建议关闭 Pydantic 对该字段的校验(用 Field(validate_default=False)),交由 attrs 全权处理
  • attrs 的 converter 返回值若类型不符 Pydantic 预期(比如返回 int 但字段注解是 str),Pydantic 会再转一次,可能出错
  • 最稳妥的做法:只用 attrs 做数据容器,Pydantic 做 API 层入参解析,两者职责隔离

复杂点在于字段级生命周期控制——attrs 的钩子发生在对象构造完成瞬间,Pydantic 的钩子则穿插在解析各层之间,混用时顺序和上下文容易错乱。

热门AI工具

更多
DeepSeek

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

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

WorkBuddy

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

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

小橡皮AI

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

豆包大模型

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

相关专题

更多
string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

6759

2023.08.02

int占多少字节
int占多少字节

int占4个字节,意味着一个int变量可以存储范围在-2,147,483,648到2,147,483,647之间的整数值,在某些情况下也可能是2个字节或8个字节,int是一种常用的数据类型,用于表示整数,需要根据具体情况选择合适的数据类型,以确保程序的正确性和性能。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

3265

2024.08.29

c++怎么把double转成int
c++怎么把double转成int

本专题整合了 c++ double相关教程,阅读专题下面的文章了解更多详细内容。

4208

2025.08.29

C++中int的含义
C++中int的含义

本专题整合了C++中int相关内容,阅读专题下面的文章了解更多详细内容。

2885

2025.08.29

lambda表达式
lambda表达式

Lambda表达式是一种匿名函数的简洁表示方式,它可以在需要函数作为参数的地方使用,并提供了一种更简洁、更灵活的编码方式,其语法为“lambda 参数列表: 表达式”,参数列表是函数的参数,可以包含一个或多个参数,用逗号分隔,表达式是函数的执行体,用于定义函数的具体操作。本专题为大家提供lambda表达式相关的文章、下载、课程内容,供大家免费下载体验。

1051

2023.09.15

python lambda函数
python lambda函数

本专题整合了python lambda函数用法详解,阅读专题下面的文章了解更多详细内容。

345

2025.11.08

Python lambda详解
Python lambda详解

本专题整合了Python lambda函数相关教程,阅读下面的文章了解更多详细内容。

574

2026.01.05

C++ Lambda 表达式与函数式编程
C++ Lambda 表达式与函数式编程

深入讲解 C++ Lambda 表达式与函数式编程范式,涵盖 Lambda 基础语法与返回值推导、值捕获与引用捕获的区别与陷阱、初始化捕获(C++14 广义捕获)、泛型 Lambda(auto 参数)、mutable 关键字修改捕获变量、std::function 类型擦除与函数包装、std::bind 参数绑定(及其被 Lambda 替代的趋势)、Lambda 在 STL 算法(sort/transform/for_each/remo

729

2026.05.06

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