Python dataclasses.replace 怎样复制并修改冻结对象

对@dataclass(frozen=True)实例，使用updated = dataclasses.replace(original, 字段名=新值)即可基于原值构造一个同类型的新对象。原实例的属性不被这次替换直接改写；调用方必须接住返回值。这里的“修改”发生在新对象的构造参数上。

官方地址：https://docs.python.org/3.14/library/dataclasses.html

确认返回新实例，而非修改旧对象

例如一份导出配置已交给当前任务使用，下一次导出想提高批量大小。把配置定义为冻结数据类，可以让普通字段赋值被拒绝；需要变更时构造下一份配置，而不是让正在使用旧配置的代码看到属性被原地换掉。

replace接收数据类实例以及明确的字段变更，返回同类型新实例。没有写进变更参数的初始化字段沿用原值。它不会自动更新原变量，也不会自动替换某个全局配置中心中的引用；这些赋值和并发发布策略仍属于应用自己的责任。

写出带校验的冻结配置示例

from dataclasses import dataclass, replace

@dataclass(frozen=True)
class ExportOptions:
    batch_size: int
    format_name: str = "csv"
    columns: tuple[str, ...] = ("code", "amount")

    def __post_init__(self):
        # 类型注解不会自动校验；构造和replace均走这里的业务规则。
        if type(self.batch_size) is not int or not 1 

这个独立示例使用Python 3.14文档所述接口，代码供读者复现，未在本文环境执行。按其语义，第一行预期为200和800，身份比较预期为False；非法批量大小会被__post_init__拒绝。original仍保留csv格式，updated采用jsonl，columns未在变更中指定。

示例把列名设计为只含字符串的元组，减少嵌套可变对象的影响；同时显式检查构造参数。数据类上的类型注解提供声明，并不会自动替应用检查批量大小范围、合法格式或列名类型。

实际调用中，先把新对象保存在局部变量，构造成功后再赋给业务所需的位置。这样初始化抛出异常时，原引用仍能继续用于原流程。这个约定并不意味着初始化一定没有外部副作用，所以__post_init__中宜保留可预测的规则，避免顺带发送消息或写外部资源。

说明初始化与派生字段限制

replace会调用数据类的__init__。在本文使用自动生成初始化方法的定义中，它也会调用__post_init__，因此新值照样受业务校验约束。若类自行定义__init__，应由该初始化方法负责是否调用后处理，不能照搬自动生成方法的假设。

标记为init=False的字段不能直接放入replace的变更参数，传入会引发ValueError。它们也不是简单从原实例复制过来；若需要派生值，应由明确的初始化或后处理逻辑重新建立。缓存、连接或隐藏状态复杂时，最好提供业务命名的工厂方法，而不是把replace当作对象内部状态的完整克隆器。

如果模型有不带默认值的InitVar初始化参数，调用replace时还需要明确提供它们。这些参数服务于初始化，不等于从原对象上可直接取得的普通字段。本文示例没有InitVar，调用者不应据此忽略自己模型中的必填构造输入。

区分冻结属性和嵌套共享

frozen限制常规属性重新赋值，不会递归冻结字段引用的列表或字典。replace也不是深拷贝：未替换的普通初始化字段会继续作为构造输入使用。下面用列表展示这一点。

from dataclasses import dataclass, replace

@dataclass(frozen=True)
class LabelSet:
    name: str
    labels: list[str]

first = LabelSet("draft", ["internal"])
second = replace(first, name="ready")
# 外层是新实例，但未替换的列表依然是同一引用。
print(first.labels is second.labels)
# 业务要隔离这个列表时，显式创建新列表；这并不是递归深拷贝。
isolated = replace(first, labels=list(first.labels))
print(first.labels is isolated.labels)

预期两个身份比较分别为True和False。second与first仍共用labels列表；isolated显式创建了新的外层列表。若列表里面又嵌套字典，list(...)依然会共享那些字典，不能把它称为完整隔离。

要让配置在业务上便于推理，优先采用不可变字段值，或在模型构造时进行明确的防御性复制。对象被多个任务共享时，外层冻结并不替代对内部可变数据的所有权设计，也不自动提供整个配置切换流程的事务性。

按异常与调用需求选择用法

不传变更字段，也会返回新对象吗？

会构造新实例，不过初始化仍会执行。带初始化副作用或派生值的模型，不能假设新旧对象的所有内部状态都完全一致。

能否用它直接修改冻结对象的字段？

不能把它理解成原地修改。应使用返回的新实例继续业务；普通直接赋值仍受冻结规则限制。

replace失败后原对象是否一定完全没变化？

replace本身不是对原对象做字段赋值，但用户自定义初始化可能访问共享对象或外部资源。只有在初始化逻辑没有这类副作用的前提下，才能对失败行为作相应保证。

读者将示例用于自己的项目时，可分别观察对象身份、原字段值、新字段值、非法输入异常和嵌套字段身份。核心判断是：是否得到了通过构造规则的新配置，以及共享了哪些数据。

参考：dataclasses.replace 官方说明