本文详解如何在 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 类型推导规范。
? 总结：放弃 pre=True 思路，坚定使用 mode='after' 的 @field_validator；将派生逻辑置于验证钩子中，既保证数据一致性，又保持接口简洁——这才是 Pydantic V2 推荐的“声明式派生属性”实践。
