Skip to content

数据类与命名元组

中等 约 30 分钟

你将构建什么

一个书店数据模型,用 @dataclass 表示可变 Book,用 NamedTuple 表示不可变 ISBN,含验证和序列化。

学习目标

  • 用类型提示和默认值定义数据类
  • 用 field() 处理列表等可变默认值
  • 创建不可变 NamedTuple
  • 为数据类添加方法和序列化

前置要求

  • 类与 __init__
  • 类型提示(基础)
  • 字典

步骤

  1. 1

    定义 Book 数据类

    @dataclass 从带类型标注的字段自动生成 __init__、__repr__ 和 __eq__。编写含 title、author、price 和 tags 的 Book。

    代码
    from dataclasses import dataclass, field
    
    @dataclass
    class Book:
        title: str
        author: str
        price: float
        tags: list = field(default_factory=list)
    
    b1 = Book("Python 101", "Alice", 29.99, ["programming", "python"])
    b2 = Book("Python 101", "Alice", 29.99, ["programming", "python"])
    print(b1)         # auto __repr__
    print(b1 == b2)   # True — auto __eq__

    预期结果

    Book 打印美观并按值比较,而非按身份。

  2. 2

    用 field 处理可变默认值

    切勿用可变默认如 tags=[]——所有实例会共享同一列表。用 field(default_factory=list) 为每个实例创建新列表。

  3. 3

    制作冻结数据类

    添加 frozen=True 使数据类不可变(如 NamedTuple)。尝试设置字段会抛出 FrozenInstanceError。对可哈希、安全数据有用。

  4. 4

    定义 ISBN NamedTuple

    NamedTuple 不可变且内存高效。定义含 group、publisher、title 和 check_digit 字段的 ISBN,及格式化完整字符串的方法。

    代码
    from typing import NamedTuple
    
    class ISBN(NamedTuple):
        group: int
        publisher: int
        title: int
        check_digit: int
        
        def __str__(self):
            return f"{self.group}-{self.publisher}-{self.title}-{self.check_digit}"
    
    isbn = ISBN(978, 316, 152410, 17)
    print(isbn)           # 978-316-152410-17
    print(isbn.publisher)  # 316 — field access by name

    预期结果

    ISBN 打印为格式化字符串,字段可按名访问。

  5. 5

    添加序列化

    用 dataclasses.asdict 将数据类转为字典,用 **kwargs 从字典构造。这是 JSON 序列化的基础。

    代码
    from dataclasses import asdict
    
    book = Book("Deep Work", "Cal Newport", 18.50, ["productivity"])
    d = asdict(book)
    print(d)
    # {'title': 'Deep Work', 'author': 'Cal Newport', 'price': 18.5, 'tags': ['productivity']}
    
    # Reconstruct from dict
    book2 = Book(**d)
    print(book2 == book)  # True

    预期结果

    往返:数据类 → 字典 → 数据类保持相等。

自己动手试试

你学到了什么

你用数据类和命名元组以最少样板建模数据——这是现代 Python 结构化数据的方式,替代冗长的 __init__ 方法。

相关资源

相关课程

  • 类

    数据类是简洁的类定义。

查阅不认识的术语

新手友好的术语表用大白话解释编程术语——变量、函数、DOM、Promise 等等。

查看术语表

解读错误信息

用大白话解释常见错误——什么意思、为什么发生、如何修复。

查看错误

← 返回主题