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

如何在Python中实现不可变数据类Frozen dataclass

落辰大大_6574

落辰大大_6574

发布时间:2026-11-01 07:32:21

|

648人浏览过

|

来源于php中文网

原创

frozen=True仅实现浅层不可变,禁止字段引用重绑定但不阻止可变对象(如list、dict)的原地修改;需用tuple/frozenset等不可变类型或__post_init__中转换。

如何在python中实现不可变数据类frozen dataclass

为什么 frozen=True 不能完全阻止修改

启用 frozen=True 后,dataclass 确实会禁止对实例字段的直接赋值(比如 obj.x = 1 会抛出 dataclasses.FrozenInstanceError),但它**不冻结字段值本身的可变性**。如果某个字段是 list 或 dict,你依然可以调用 .append()、.update() 这类原地修改方法。

常见错误现象:FrozenInstanceError 没出现,但对象“看起来”被改了——其实是内部容器被篡改了。

  • 使用场景:需要真正语义不可变(如作为 dict 的 key、用于缓存键、多线程共享)
  • 根本原因:Python 的“不可变”指引用不可重绑定,而非对象内容不可变
  • 解决方向:要么用真正不可变类型(tuple, frozenset),要么在初始化时做深拷贝或转换

如何安全地初始化含可变默认值的 frozen dataclass

直接写 field(default=[]) or field(default={}) 在 frozen=True 下仍会报错——不是因为冻结,而是因为可变默认值本身在 dataclass 中就是禁止的(哪怕没开 frozen)。必须用 default_factory,且工厂返回的必须是不可变对象,或立即转为不可变。

@dataclass(frozen=True)
class Config:
    tags: tuple = field(default_factory=tuple)  # ✅ 安全:tuple 是不可变的
    aliases: frozenset = field(default_factory=frozenset)  # ✅
    # ❌ 不要这样:default_factory=list → 实例字段仍是可变 list
  • 避免 default_factory=list + frozen=True 组合,看似合法,实则埋雷
  • 若业务逻辑确实需要 list 输入,应在 __post_init__ 中转成 tuple:object.__setattr__(self, 'tags', tuple(self.tags))
  • 注意:在 __post_init__ 中修改字段必须用 object.__setattr__,否则触发 FrozenInstanceError

copy.deepcopy 对 frozen dataclass 的影响

对 frozen dataclass 实例调用 copy.deepcopy 是安全的,结果仍是 frozen 实例——但前提是所有字段值本身支持深拷贝,且没有自定义 __deepcopy__ 破坏冻结语义。

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

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

下载

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

容易踩的坑:deepcopy 不会帮你把 list 字段变成 tuple;它只复制结构,不转换类型。所以如果原始实例字段是 [1,2],深拷贝后还是可变 list。

  • 性能影响:深拷贝开销大,尤其嵌套深或含大容器时;如非必要,优先用不可变字段设计
  • 兼容性注意:某些 C 扩展对象(如 NumPy 数组)可能不完全遵循标准 __deepcopy__ 协议
  • 替代方案:用 dataclasses.replace() 创建新实例(仅适用于字段值本身不可变的情况)

与 NamedTuple 和 typing.NamedTuple 的关键区别

很多人误以为 frozen=True 的 dataclass 就等价于 NamedTuple,其实不然。最实质的差异在于:NamedTuple 的字段**天生不可变且不可扩展**(无法动态加属性、无法继承添加新字段),而 frozen dataclass 仍保留普通类的运行时行为(比如能定义方法、支持继承、允许 __slots__ 控制)。

典型错误:试图给 frozen dataclass 实例动态赋值 obj._cache = {} —— 会失败;但 NamedTuple 连这个尝试都不允许(AttributeError 更早抛出)。

  • 如果你只需要轻量级、纯数据、零开销的不可变结构,typing.NamedTuple 更严格、更省内存
  • 如果你需要方法、类型提示增强、或未来可能解冻/重构,frozen dataclass 更灵活
  • 注意:两者都**不自动冻结嵌套对象**——这是最容易被忽略的复杂点,无论选哪种,嵌套的 dict 或 list 都得手动处理

热门AI工具

更多
咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

创客贴AI

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

DeepSeek

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

PixPix
PixPix Hot

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

WorkBuddy

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

AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

豆包大模型

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

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

相关专题

更多
python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

1851

2023.07.20

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

4964

2023.07.25

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

1789

2023.07.31

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

29837

2023.08.03

python环境变量的配置
python环境变量的配置

Python是一种流行的编程语言,被广泛用于软件开发、数据分析和科学计算等领域。在安装Python之后,我们需要配置环境变量,以便在任何位置都能够访问Python的可执行文件。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

3547

2023.08.04

python eval
python eval

eval函数是Python中一个非常强大的函数,它可以将字符串作为Python代码进行执行,实现动态编程的效果。然而,由于其潜在的安全风险和性能问题,需要谨慎使用。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

3567

2023.08.04

scratch和python区别
scratch和python区别

scratch和python的区别:1、scratch是一种专为初学者设计的图形化编程语言,python是一种文本编程语言;2、scratch使用的是基于积木的编程语法,python采用更加传统的文本编程语法等等。本专题为大家提供scratch和python相关的文章、下载、课程内容,供大家免费下载体验。

1223

2023.08.11

python合并两个列表
python合并两个列表

Python是一种强大的编程语言,具有许多方便的功能和工具。在Python中,有多种方法可以合并两个列表。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

616

2023.08.10

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

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

100

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