如何在 Pydantic V2 中基于已验证输入动态构建类属性（非输入字段）_技术教程

本文详解如何在 pydantic v2 中通过 `@field_validator`（替代已弃用的 `@validator`）在模型实例化后自动计算并设置只读类属性，如 `system: ase.atoms`，无需用户传入，且该属性可直接访问、序列化友好、类型安全。

在 Pydantic V2 中，若需根据已验证的输入字段（如 foo 和 bar）自动派生一个新属性（如 baz 或更复杂的 system: ase.Atoms），该属性不应出现在初始化参数中，但又必须作为公共实例属性可用（即不以 _ 开头，支持 model_dump() 序列化），推荐使用 @field_validator 配合 mode='after' —— 这是 V2 的标准、健壮且类型安全的方式。

⚠️ 注意：V2 已完全移除 @validator 装饰器及 pre=True/always=True 语义；旧代码需迁移。mode='before' 适用于预解析（如字符串转数字），而 mode='after' 才能确保所有字段已完成类型校验与约束检查，此时访问 values 安全可靠。

以下为完整实现示例：

from pydantic import BaseModel, field_validator
from typing import Optional

class MyClass(BaseModel):
    foo: int
    bar: int
    baz: int  # 声明为普通字段（非 PrivateAttr），参与序列化

    @field_validator('baz', mode='after')
    def compute_baz(cls, v, info):
        # info.data 包含所有已验证的字段值（dict）
        # 若 v 已被显式传入（如 JSON 中含 "baz"），则保留；否则按逻辑计算
        if v is None or v == 0:  # 可选：仅当未提供时才计算
            return info.data.get('foo', 0) * info.data.get('bar', 0)
        return v

# ✅ 正常使用（baz 自动计算）
obj = MyClass(foo=4, bar=5)
print(obj.baz)  # 输出: 20
print(obj.model_dump())  # {'foo': 4, 'bar': 5, 'baz': 20}

对于更贴近你需求的 Thermopotentiostat 场景（动态构建 ase.Atoms 对象），可进一步封装：

from ase import Atoms
from pydantic import BaseModel, field_validator

class Thermopotentiostat(BaseModel):
    atom_symbols: list[str]
    positions: list[list[float]]  # shape: (n, 3)
    cell: list[list[float]] = [[1.0, 0.0, 0.0], [0.0, 1.0, 0.0], [0.0, 0.0, 1.0]]
    system: Atoms  # 公共属性，非私有，可序列化（需自定义 serializer）

    @field_validator('system', mode='after')
    def build_system(cls, v, info):
        data = info.data
        # 若 system 未传入，则基于其他字段构建
        if not isinstance(v, Atoms):
            return Atoms(
                symbols=data['atom_symbols'],
                positions=data['positions'],
                cell=data['cell'],
                pbc=True
            )
        return v

    # （可选）添加自定义序列化，避免 ase.Atoms 默认无法 JSON 序列化
    class Config:
        arbitrary_types_allowed = True  # 允许 ase.Atoms 类型

✅ 关键优势：

system 是一级公民属性，thermo.system 直
接可用；
支持 model_dump(exclude={'system'}) 灵活控制导出；
若后续需持久化，可配合 @computed_field（Pydantic ≥2.4）声明只读计算字段（不参与 model_dump()，除非显式设置 repr=False）；
所有验证逻辑集中、可测试、符合 Pydantic V2 类型推导规范。