咨询无类型提示的dataclass字段相关官方文档位置

示例代码 #

from dataclasses import dataclass, asdict

@dataclass
class Example:
    typed: str = "a"
    nontyped = "nt_value"  

# Now let's make some tests and see 'nontyped' behaviour

ex = Example()
ex2 = Example()

print(ex)
# Example(typed='a')

print(ex.nontyped)
# nt_value

print(asdict(ex))
# {'typed': 'a'}

ex.nontyped = 'new_value'
print(ex.nontyped)
# new_value

print(ex2.nontyped)
# nt_value

print(asdict(ex))
# {'typed': 'a'}

print(asdict(ex2))
# {'typed': 'a'}

特性解释 #

@dataclass装饰器仅将带有类型标注的变量识别为dataclass的实例字段，这类字段会被纳入对象的__repr__输出、asdict()转换等dataclass专属逻辑中。而nontyped这种无类型标注的变量属于普通类属性，完全遵循Python类属性的行为规则，不会被dataclass的机制处理，因此不会出现在对象的字符串表示或asdict()的结果里。

文档参考位置 #

你可以在Python官方文档的dataclasses模块章节中查阅该特性的详细说明：

• 核心规则：@dataclass默认仅处理带类型标注的属性，这些属性会自动生成__init__、__repr__等方法；无类型标注的类属性不受dataclass管理。
• 具体可查看dataclasses.dataclass装饰器的定义部分，其中明确了字段的识别条件——只有带类型标注的变量才会被视为dataclass字段（除非通过fields()手动配置，默认行为如上）。

内容的提问来源于stack exchange，提问作者Alexander C