NamedTuple本质是继承tuple的不可变类，字段需定义时传入且不支持动态赋值；支持末尾字段默认值（Python 3.6+），类型注解仅用于静态检查；适用轻量不可变结构，复杂逻辑应选dataclass。
NamedTuple 的本质是类，不是普通元组
很多人以为 typing.NamedTuple 只是给元组加了字段名，其实它生成的是一个继承自 tuple 的新类，实例一创建就不可变——连 __dict__ 都没有，根本没法动态赋值。
常见错误现象：obj.field = new_value 会直接抛 AttributeError: can't set attribute，不是静默失败。
- 必须在定义时通过
__new__或构造调用传入所有字段值（位置或关键字均可） - 不支持默认值写法
field: int = 0（这是dataclass的语法），要用_field_defaults或继承typing.NamedTuple并手动定义__new__ - 字段类型注解仅用于静态检查（如 mypy），运行时不强制校验
正确写法：用类定义语法 + 类型注解
最清晰、最常用的方式是用类语法定义，字段名和类型写在类体里：
from typing import NamedTuple <p>class Point(NamedTuple): x: float y: float label: str = "origin" # ✅ Python 3.6+ 支持默认值（注意：仅限末尾字段）</p>
这样创建实例：p = Point(1.0, 2.0) → Point(x=1.0, y=2.0, label="origin")；Point(1.0, 2.0, "top") 覆盖默认值。
立即学习“Python免费学习笔记（深入）”；
⚠️ 容易踩的坑：
- 默认值字段**必须放在非默认值字段之后**，否则报
SyntaxError - 如果想让中间字段有默认值，得改用
collections.namedtuple配合_replace()，或换dataclass(frozen=True) -
NamedTuple不支持__init__方法重载——所有初始化逻辑必须塞进__new__，且要显式调用父类super().__new__
运行时不可变性 vs 静态类型安全
NamedTuple 的不可变性是运行时保障的（底层是 tuple），但类型注解只影响静态分析工具。比如：
p = Point(1.0, 2.0) p.x = 999 # ❌ 运行时报 AttributeError p.z = 123 # ❌ 同样报错：没有 __dict__，无法新增属性
但如果你用 cast 或关闭类型检查，myPy 不会拦住非法赋值，只有运行时才暴露问题。
- 性能上，
NamedTuple实例比dict或普通对象更轻量，内存占用接近原生tuple - 兼容性：Python 3.5+ 可用，但默认值支持从 3.6+ 开始；3.8+ 才支持
TypedDict风格的字面量写法（不推荐混用） - 调试时注意：
print(p)输出带字段名的格式，但isinstance(p, tuple)返回True
什么时候不该用 NamedTuple
当你要的对象需要方法、属性计算、可变状态，或者字段默认值逻辑复杂（比如依赖其他字段），NamedTuple 就不合适了。
- 需要方法？→ 改用
dataclass(frozen=True)，它支持@property和自定义__post_init__ - 需要部分字段可选且非末尾？→ 用
dataclass或attrs，NamedTuple的默认值机制太死板 - 只是临时拼个结构体传参？→ 确认是否真需要不可变性；如果只是怕误改，用
dict+ 文档说明可能更灵活
真正关键的点在于：不可变性是硬约束，不是风格建议。一旦选了 NamedTuple，就得接受它“定义即冻结”的刚性——连字段顺序都不能 runtime 修改。
