Python 本身没有内置的、名为 “struct” 的、与 C 语言完全一致的原生结构体类型。但是，Python 作为一门高级动态语言，提供了多种机制来实现结构体的核心功能：**将多个相关的数据项组合成一个单一的、可管理的单元**，并可以按名称或位置访问其成员。 主要的实现方式有以下几种，各有其适用场景[ref_2][ref_3][ref_6]： | 实现方式 | 核心特点 | 优点 | 缺点 / 适用场景 | | :--- | :--- | :--- | :--- | | **`collections.namedtuple`** | 不可变，轻量级，支持索引和属性访问。 | 高效、内存友好、自带 `__repr__`、`_asdict` 等方法。 | **不可变**，无法修改字段值，适用于数据记录[ref_6]。 | | **`dataclasses.dataclass` (Python 3.7+)** | 可变，功能强大，语法简洁，可自动生成方法。 | 代码简洁，支持默认值、类型注解、比较方法等，是**现代Python的最佳实践**。 | 需要 Python 3.7 或以上版本。 | | **自定义类 (`class`)** | 完全可控，最灵活的基础方式。 | 灵活性最高，可以添加任何方法或属性。 | 代码量相对较多，早期Python版本的主要模拟方式[ref_2][ref_3]。 | | **`types.SimpleNamespace`** | 可变，属性可动态添加/删除。 | 极其简单，属性访问使用点号。 | 无固定字段定义，结构松散，适合快速组装对象。 | | **`struct.Struct` (用于二进制)** | 用于处理二进制数据与Python值之间的转换。 | 专为二进制打包/解包设计，与C结构体二进制布局对应。 | **不用于创建对象**，仅用于字节序列转换。 | 下面通过具体代码示例详细说明最常用的几种方式。 ### 1. 使用 `collections.namedtuple` `namedtuple` 位于 `collections` 模块，用于创建具有命名字段的轻量级、不可变对象。它非常适合于存储数据，但不适合需要修改数据或包含复杂逻辑的场景[ref_6]。 ```python from collections import namedtuple # 定义一个名为 `Point` 的结构体，包含 `x` 和 `y` 两个字段 Point = namedtuple('Point', ['x', 'y']) # 实例化一个结构体变量 p1 = Point(10, 20) # 或者使用关键字参数 p2 = Point(x=5, y=15) # 访问字段：通过属性名或索引 print(p1.x, p1.y) # 输出: 10 20 print(p1[0], p1[1]) # 输出: 10 20 # 自带一些实用方法 print(p1._asdict()) # 输出: {'x': 10, 'y': 20}，转换为字典 p3 = p1._replace(x=99) # 返回一个新实例，x被替换为99 print(p3) # 输出: Point(x=99, y=20) # 注意：namedtuple是不可变的，以下操作会报错 # p1.x = 100 # AttributeError: can‘t set attribute ``` ### 2. 使用 `dataclasses.dataclass` (推荐) `dataclass` 是 Python 3.7 引入的装饰器，它可以极大地简化类的定义，自动生成 `__init__`、`__repr__`、`__eq__` 等方法，是目前实现“可变结构体”最优雅和强大的方式[ref_5]。 ```python from dataclasses import dataclass, field from typing import List # 使用装饰器定义 @dataclass class Student: # 定义字段及其类型注解。可以设置默认值。 name: str age: int grades: List[float] = field(default_factory=list) # 默认值为空列表 active: bool = True # 带有默认值的字段必须放在后面 # 实例化。自动生成 __init__ 方法。 s1 = Student("张三", 20, [88.5, 92.0]) s2 = Student("李四", 22) print(s1) # 自动生成 __repr__: Student(name='张三', age=20, grades=[88.5, 92.0], active=True) print(s1.name) # 输出: 张三 # dataclass 是可变的 s1.age = 21 print(s1.age) # 输出: 21 # 自动生成 __eq__ 方法，用于比较内容 s3 = Student("张三", 21, [88.5, 92.0], True) print(s1 == s3) # 输出: True，因为所有字段值都相等 # 更多高级用法：冻结实例、后初始化处理等 @dataclass(frozen=True) # 设置为不可变，类似 namedtuple class FrozenPoint: x: int y: int fp = FrozenPoint(1, 2) # fp.x = 3 # 会报错：dataclasses.FrozenInstanceError ``` ### 3. 使用自定义类 (`class`) 这是最基础的方式，通过定义 `__init__` 方法来初始化属性。在 `dataclass` 出现之前，这是模拟结构体的主要方法[ref_2][ref_3]。 ```python class Employee: # 在 __init__ 方法中定义“结构体”的字段 def __init__(self, emp_id, name, department): self.emp_id = emp_id self.name = name self.department = department # 你可以选择性地添加自定义方法 def get_info(self): return f"{self.emp_id}: {self.name} from {self.department}" # 实例化 e1 = Employee(1001, "王五", "技术部") print(e1.name) # 输出: 王五 print(e1.get_info()) # 输出: 1001: 王五 from 技术部 # 字段是可变的 e1.department = "研发部" print(e1.department) # 输出: 研发部 ``` ### 4. 使用 `types.SimpleNamespace` `SimpleNamespace` 提供了一种极简的属性访问方式，无需预先定义字段。 ```python from types import SimpleNamespace # 直接在实例化时或之后添加属性 person = SimpleNamespace(name="赵六", age=30) # 动态添加新属性 person.city = "北京" print(person.name, person.age, person.city) # 输出: 赵六 30 北京 ``` ### 5. 使用 `struct.Struct` 处理二进制结构体 **注意**：`struct` 模块的 `Struct` 类**并不是用来创建Python对象的**。它的核心功能是根据一个格式字符串，将一组Python值打包 (`pack`) 成字节流（二进制数据），或者将字节流解包 (`unpack`) 成Python值。这在与C语言程序进行二进制数据交互、读写文件格式（如图像头、网络协议包）时至关重要。 ```python import struct # 定义一个与C结构体相对应的格式字符串 # ‘I’ 表示 unsigned int (4字节), ‘10s’ 表示 10字节的字符串, ‘f’ 表示 float (4字节) # 这类似于C中的：struct Packet { uint32_t id; char name[10]; float score; }; format_string = ‘I 10s f‘ packer = struct.Struct(format_string) # 准备数据 pkt_id = 12345 pkt_name = b‘Test‘ # 必须是字节类型，注意长度不超过10 pkt_score = 88.5 # 打包：将Python值转换为字节序列 packed_data = packer.pack(pkt_id, pkt_name, pkt_score) print(f‘打包后的字节: {packed_data}‘) # 解包：将字节序列转换回Python值 unpacked_data = packer.unpack(packed_data) print(f‘解包后的元组: {unpacked_data}‘) # 输出: (12345, b‘Test‘, 88.5) # 注意：字符串字段返回的是 bytes 对象 ``` ### 总结与选择建议 - **通用数据容器（需要修改值）**：首选 **`@dataclass`**。它语法现代，功能全面，是Python社区的标准实践[ref_5]。 - **只读数据记录**：选择 **`namedtuple`**。它更轻量，性能略优，适用于存储后不修改的数据[ref_6]。 - **需要完全控制或旧版本兼容**：使用**自定义类**。这是最灵活的基础[ref_2][ref_3]。 - **快速、临时的属性集合**：使用 **`SimpleNamespace`**。 - **与C语言进行二进制数据交互**：使用 **`struct`** 模块进行打包和解包[ref_1]。 因此，对于“Python中结构体怎么用”这个问题，答案是根据你的具体需求（可变性、性能、功能复杂度、Python版本）从上述方案中选择最合适的一种。对于大多数存储和操作结构化数据的场景，`dataclass` 是最佳选择。