NamedTuple 是不可变的轻量级类，支持按名访问字段，解决了普通 tuple 需靠索引猜含义的问题；内存开销近似 tuple，不支持直接修改字段，但可通过 _replace()（仅 collections 版）或解包重建更新。
NamedTuple 是什么，和普通 tuple 有什么区别
NamedTuple 是 typing 模块（Python 3.5+）和 collections 模块都提供的类型构造器，它生成的是不可变、轻量级的类，本质仍是元组，但字段可按名访问。和普通 tuple 相比，它解决了“靠索引猜含义”的问题——比如 user[0] 到底是 name 还是 age，而 user.name 一目了然。
- 字段名在实例化后不可修改，也不能新增属性（
<strong>slots</strong>生效） - 内存开销接近
tuple，远小于dataclass或普通 class - 不支持默认值（除非用
typing.NamedTuple配合field(default=...)，但仅限 Python 3.6.1+；更推荐用collections.namedtuple+_replace()手动处理）
两种定义方式：collections vs typing，选哪个
Python 中有两种主流写法，行为略有差异，容易混淆：
-
collections.namedtuple('Point', ['x', 'y'])：返回一个类，兼容所有 Python 3.x，支持_fields、_asdict()、_replace() -
from typing import NamedTuple; class Point(NamedTuple): x: int; y: float：是类型提示友好的写法，支持字段注解、默认值（需用field(default=...)）、IDE 自动补全更强，但运行时只是普通namedtuple的子类
常见错误现象：
- 用
typing.NamedTuple定义后，误以为能直接调用_asdict()—— 实际上它不继承collections.namedtuple的方法，得手动实现或改用collections版本 - 在 mypy 检查时，用
collections.namedtuple缺少类型注解，会被报Untyped namedtuple警告
推荐策略：
立即学习“Python免费学习笔记（深入）”；
- 只需运行时功能（如序列化、解包），用
collections.namedtuple - 需要静态类型检查 + IDE 支持 + 默认值，用
typing.NamedTuple，并接受它不带_asdict()等方法的事实
字段默认值怎么加，为什么不能直接写 y=0
在 collections.namedtuple 中，不能直接在字段列表里写默认值，比如 namedtuple('Config', 'host port=80') 会抛 SyntaxError。正确做法是：
-
使用
collections.namedtuple的_replace()构造默认实例：Config = namedtuple('Config', 'host port') DEFAULT_CONFIG = Config(host='localhost', port=80) # 后续用 config = DEFAULT_CONFIG._replace(port=8080) -
使用
typing.NamedTuple（Python 3.6.1+）配合field：from typing import NamedTuple, Optional from dataclasses import field </li></ul><p>class Config(NamedTuple): host: str port: int = 80 # ✅ 直接赋值即可（注意：这是 typing.NamedTuple 的语法糖，底层调用 field(default=80)） debug: bool = False
注意点：
-
typing.NamedTuple中字段必须按“有默认值的放后面”顺序声明，否则报SyntaxError: non-default argument follows default argument -
field(default_factory=list)不被支持（会报TypeError），要用field(default_factory=lambda: [])曲线救国
NamedTuple 实例不能修改，但想更新部分字段怎么办
NamedTuple实例是不可变的，user.age = 30会触发AttributeError。正确更新方式只有两个：-
用
_replace()（仅collections.namedtuple提供）：User = namedtuple('User', 'name age') u = User('Alice', 25) u2 = u._replace(age=26) # ✅ 返回新实例 -
用解包重建（通用，但易出错）：
u2 = User(u.name, 26) # ❌ 字段多时难维护；✅ 适用于字段少且明确的场景
性能影响：
-
_replace()内部是浅拷贝 + 字段覆盖，比新建元组略快，但差别微乎其微 - 如果频繁更新，说明不该用
NamedTuple，该换dataclass(frozen=False)或普通 class
容易踩的坑：
- 对
typing.NamedTuple实例调用_replace()会失败（没有该方法），必须自己实现或转成 dict 再构造 - 把
NamedTuple当字典用（比如if 'name' in user）会返回False，因为它不支持<strong>contains</strong>，得用user._fields或user._asdict().keys()（后者仅 collections 版本）
字段名含空格、连字符或以数字开头？不行。命名规则和变量一样：只能是字母/下划线开头，后续可含字母、数字、下划线。否则
ValueError: Type names and field names can only contain alphanumeric characters and underscores。 -
