每日一个编程小技巧：使用 namedtuple 替代普通元组

原创已于 2025-02-11 11:09:15 修改 · 655 阅读

20 ·

CC 4.0 BY-SA版权

文章标签：

#python #开发语言

于 2025-02-11 10:40:27 首次发布

在 Python 中，namedtuple 是一个非常有用的数据结构，它可以让你的代码更加清晰和易读。相比于普通的元组，namedtuple 允许你为元组的每个元素命名，从而避免使用索引来访问元素。

什么是 `namedtuple`？

namedtuple 是 Python 标准库 collections 模块中的一个函数，它允许你创建一个带有命名字段的元组。与普通元组不同，namedtuple 的每个元素都有一个名字，你可以通过名字来访问元素，而不必依赖索引。

为什么使用 `namedtuple`？

提高代码可读性：通过为元组的元素命名，代码的意图更加清晰。
减少错误：使用名字访问元素可以避免因索引错误而导致的 bug。
增强代码可维护性：命名元组使得代码更容易理解和修改。

实例展示

假设我们有一个表示二维点的元组：

python

复制

point = (3, 4)

要访问这个点的 x 坐标，你需要使用索引 point[0]，这看起来不够直观。如果我们使用 namedtuple，代码会变得更加清晰：

from collections import namedtuple

# 创建一个名为 Point 的 namedtuple
Point = namedtuple('Point', ['x', 'y'])

# 实例化一个 Point 对象
point = Point(3, 4)

# 访问 x 坐标
print(point.x)  # 输出: 3

在这个例子中，point.x 比 point[0] 更加直观和易读。

拓展延伸

默认值：namedtuple 不支持默认值，但你可以通过继承 namedtuple 并重写 __new__ 方法来实现。

from collections import namedtuple

class Point(namedtuple('Point', ['x', 'y'])):
    __slots__ = ()
    def __new__(cls, x=0, y=0):
        return super().__new__(cls, x, y)

point = Point(y=4)
print(point)  # 输出: Point(x=0, y=4)

不可变性：namedtuple 是不可变的，这意味着一旦创建，你就不能修改它的值。如果你需要可变的数据结构，可以考虑使用 dataclasses（Python 3.7+）。

from dataclasses import dataclass

@dataclass
class Point:
    x: int = 0
    y: int = 0

point = Point(y=4)
point.x = 3
print(point)  # 输出: Point(x=3, y=4)

性能优势：namedtuple 比普通的类更加轻量级，因此在需要高性能的场景下，namedtuple 是一个不错的选择。

序列化：namedtuple 可以很容易地转换为字典或 JSON，方便数据的序列化和反序列化。

import json
from collections import namedtuple

Point = namedtuple('Point', ['x', 'y'])
point = Point(3, 4)

# 转换为字典
point_dict = point._asdict()
print(point_dict)  # 输出: {'x': 3, 'y': 4}

# 转换为 JSON
point_json = json.dumps(point_dict)
print(point_json)  # 输出: {"x": 3, "y": 4}