讲师中心 微信公众号

工具推荐

视频效率加速
AniShort
AniShort

AI短剧协同制作平台

剧云
剧云

中文短剧剧本制作平台

Seko
Seko

AI短剧一键生成成片

updream

一键生成高质量推广成片

Python frozen dataclass 的不可变设计

阿雪姑娘_1436

阿雪姑娘_1436

发布时间:2026-02-25 19:52:03

|

969人浏览过

|

来源于php中文网

原创

frozen=True仅冻结实例属性赋值,不阻止可变对象(如list、dict)的原地修改;嵌套dataclass不自动继承frozen;__post_init__是唯一可修改字段的合法时机,须用object.__setattr__;更新字段应使用replace()创建新实例。

python frozen dataclass 的不可变设计

为什么 frozen=True 不能阻止所有修改

因为 frozen 只冻结实例属性的赋值,不冻结可变对象内部状态。比如 list 或 dict 字段仍能被原地修改,dataclass 不会拦截 my_obj.items.append(1) 这类操作。

常见错误现象:AttributeError: can't set attribute 没出现,但数据却“悄悄变了”;调试时发现同一实例在不同位置输出不同内容。

  • 使用场景:需要逻辑上不可变(如配置、缓存 key、hashable 结构),但字段类型选了 list 或 dict
  • 解决办法:用 tuple 替代 list,用 frozenset 或 MappingProxyType 封装字典
  • 示例:items: tuple[int, ...] = () 比 items: list[int] = field(default_factory=list) 更符合 frozen 意图

嵌套 dataclass 字段的 frozen 会传染吗

不会自动传染。父类设了 frozen=True,子类仍可自由修改——除非子类也显式声明 frozen=True。这是常见误解,导致以为“顶层冻结=全链冻结”。

容易踩的坑:父类 Config 冻结了,但其中字段 db: Database 是个非 frozen 的 dataclass,调用 config.db.host = "new" 依然成功。

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

Python Hardener
Python Hardener

通过完整的安全审查、代码整洁重构、健壮的错误处理、正确的日志记录以及完整的文档字符串覆盖,强化 Python 脚本。

下载
  • 检查方式:用 hasattr(cls, '__dataclass_params__') 和 getattr(cls, '__dataclass_params__', {}).get('frozen', False)
  • 推荐做法:所有参与组合的 dataclass 都统一加 frozen=True,否则不可变契约就断在中间层
  • 性能影响:嵌套 unfrozen 类不会拖慢父类创建,但会让整个结构失去 hashability 和语义一致性

__post_init__ 里还能改字段吗

可以,但仅限初始化阶段。frozen=True 的限制在 __post_init__ 执行完毕后才生效,所以这是唯一合法的“破冰窗口”。

使用场景:字段需依赖其他字段计算(如 full_name 基于 first + last),或做轻量校验/标准化(如把输入字符串转成 Path)。

  • 注意:必须用 object.__setattr__(self, 'field', value),直接写 self.field = value 会触发 AttributeError
  • 错误示范:self.cache = {} —— 即使用了 object.__setattr__,若 cache 是可变容器,后续仍可被外部修改
  • 兼容性:Python 3.7+ 行为一致,但 3.11+ 对 __post_init__ 中多次 object.__setattr__ 的检查更严格

想让 frozen dataclass 支持字段更新怎么办

不能直接改,得换思路:用 replace() 创建新实例。这是标准且安全的做法,不是 workaround。

常见错误现象:试图绕过 frozen 用 vars(obj)['x'] = 1 或 type(obj).__dict__['x'].__set__(obj, 1),结果破坏了 __hash__ 一致性或引发未定义行为。

  • 正确姿势:from dataclasses import replace; new_obj = replace(old_obj, x=42)
  • 参数差异:replace 不调用 __post_init__,也不校验类型;若需校验,得自己封装一层工厂函数
  • 性能提示:replace 是浅拷贝,嵌套可变对象(如 list)仍共享引用;真要深更新,得配合 copy.deepcopy 或专用工具

最易被忽略的一点:replace 返回的是新对象,但很多人忘了重新赋值变量,还拿着旧引用继续用——这比 mutable 更难 debug。

热门AI工具

更多
二狗PPT
二狗PPT Hot

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

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

超级麦吉

一款通过数字员工协作完成调研、数据分析与文档制作的AI办公平台。

DeepSeek

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

创客贴AI

创客贴AI是一款AI图像与设计工具,AI辅助的智能在线设计工具。

Laper
Laper Hot

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

豆包大模型

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

WorkBuddy

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

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

相关专题

更多
js 字符串转数组
js 字符串转数组

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

1918

2023.08.03

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

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

3164

2023.09.04

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

6364

2023.10.24

字符串介绍
字符串介绍

字符串是一种数据类型,它可以是任何文本,包括字母、数字、符号等。字符串可以由不同的字符组成,例如空格、标点符号、数字等。在编程中,字符串通常用引号括起来,如单引号、双引号或反引号。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

6509

2023.11.24

java读取文件转成字符串的方法
java读取文件转成字符串的方法

Java8引入了新的文件I/O API,使用java.nio.file.Files类读取文件内容更加方便。对于较旧版本的Java,可以使用java.io.FileReader和java.io.BufferedReader来读取文件。在这些方法中,你需要将文件路径替换为你的实际文件路径,并且可能需要处理可能的IOException异常。想了解更多java的相关内容,可以阅读本专题下面的文章。

8054

2024.03.22

php中定义字符串的方式
php中定义字符串的方式

php中定义字符串的方式:单引号;双引号;heredoc语法等等。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

12454

2024.04.29

go语言字符串相关教程
go语言字符串相关教程

本专题整合了go语言字符串相关教程,阅读专题下面的文章了解更多详细内容。

6459

2025.07.29

c++字符串相关教程
c++字符串相关教程

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

7247

2025.08.07

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

0

2026.11.12

热门下载

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

精品课程

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

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