Python dataclass 字段清单：构造时传入的值，为什么没有出现在 asdict 里
把一段原始记录交给 dataclass，构造函数正常接收了它，导出字典时却找不到这个输入；类里另一项默认配置也没有进入字段列表。与其怀疑序列化漏字段，不如先看注解：普通字段、InitVar 和 ClassVar 在数据类中承担不同角色。“出现在类定义里”和“属于实例字段”并不等价。
用一次构造同时观察三种角色
下面构造一个只有演示文字的记录。raw 是构造时传入的原始标签，经过清理后保存在 label；prefix 是类级配置；label 才是普通字段。保存为 demo.py 后运行 python demo.py。代码打印生成的字段清单、导出字典和实例字典，三个观察面可以相互核对，避免仅凭点号能否访问判断。
from dataclasses import dataclass, field, fields, asdict, InitVar
from typing import ClassVar
@dataclass
class Record:
raw: InitVar[str]
label: str = field(init=False)
prefix: ClassVar[str] = "team"
def __post_init__(self, raw):
self.label = self.prefix + ":" + raw.strip()
record = Record(" alpha ")
print("fields:", [item.name for item in fields(record)])
print("asdict:", asdict(record))
print("instance:", vars(record))
print("raw-exists:", hasattr(record, "raw"))
print("class-setting:", record.prefix)
assert [item.name for item in fields(record)] == ["label"]
assert asdict(record) == {"label": "team:alpha"}
assert "raw" not in vars(record) and "prefix" not in vars(record)第一行只有 label，第二行导出 label 对应的 team:alpha，第三行实例字典也只保存 label。raw 传入了 __post_init__，但没有自动留在实例中；prefix 可以通过实例读取，却来自类属性。它们都不出现在 fields 返回的正式字段清单，也没有被 asdict 当成普通字段导出。
构造输入不等于长期状态
InitVar 适合只在初始化阶段使用的辅助参数，例如一段待规范化的文字或查找所需的上下文。数据类会把它加入生成的构造函数，并按声明顺序传给 __post_init__。如果你确实需要以后继续访问，就应明确设计一个普通字段，或者在初始化方法中有意保存；别依赖注解让它自动出现。
AI生成概念示意图：构造输入经过处理后离开，普通字段保存结果，类配置单独位于上层。
例子特意没有给 raw 设置类级默认值，因此 hasattr 返回 False。如果给初始化变量放一个默认值，属性查找可能从类上读到它，却仍不能证明本次构造时的值被保存。排查时应看 fields、实际实例状态和初始化代码，不能只做一次 hasattr 检查，然后把两种完全不同的来源当成同一个字段。
类配置不会变成不可修改常量
ClassVar 告诉数据类跳过这项注解，不把它纳入生成的字段机制。它并没有自动禁止实例上建立同名属性，也没有给类属性加只读保护。需要不可变配置或约束修改入口时，应另行设计相应机制。把某项写成 ClassVar，是说明它属于类的约定，而不是在运行时加上一把安全锁。
同样，普通类型注解通常不会替你做运行时值检查。raw 标了字符串，不意味着传入其他对象时构造函数会统一给出友好错误；本例调用 strip，错误可能直到那里才出现。真实入口应根据输入契约校验，再决定如何转换。不要把字段清单准确误认为内容已经合法，两者是分开的验收问题。
还要留意 __post_init__ 的调用条件：它由生成的 __init__ 负责调用。若你自己编写构造函数，或者关闭自动生成，不能想当然地认为这个后处理阶段仍会自动发生。继承结构复杂时，也应检查实际调用路径，并用最小构造样本验证派生字段是否已经计算完成。
本例使用 init=False 的 label，表示构造调用者不能直接给它传值，而由初始化过程生成。这个普通字段仍会进入字段清单和字典导出。它和 InitVar 恰好相反：一个留下状态却不接受常规构造参数，一个接收构造参数却不自动留下状态。把这两种角色区分开，导出缺字段的问题就有了明确检查顺序。
资料核对日期：2026年10月2日（北京时间）。示例在 Python 3.12.14 中独立运行，具体输出以本文实测为准。
