### Django 中 `models.Choices` 的用法 在 Django 模型定义中，可以利用 `models.TextChoices`, `models.IntegerChoices` 或者自定义继承于 `models.Choices` 来创建枚举选项类。这有助于更好地管理和维护字段的选择项。 #### 定义 Choices 类 通过定义一个内部的静态类来列举所有可能的状态值，并给这些状态赋予更具描述性的标签： ```python from django.db import models class Device(models.Model): class Status(models.TextChoices): AVAILABLE = 'AV', 'Available' CHECKED_OUT = 'CO', 'Checked Out' status = models.CharField( max_length=2, choices=Status.choices, default=Status.AVAILABLE, ) def checkout(self): self.status = Device.Status.CHECKED_OUT # 更新设备状态为已借出 self.save() def return_device(self): self.status = Device.Status.AVAILABLE # 更新设备状态为空闲可用 self.save() ``` 上述代码展示了如何使用 `TextChoices` 枚举类型[^3]。每当需要更改模型中的字段时，比如增加新的状态，都需要执行数据库迁移以同步变更到实际使用的数据库表结构中[^2]。 对于整数类型的选项，则可以选择 `IntegerChoices`: ```python class Order(models.Model): class PaymentStatus(models.IntegerChoices): PENDING = 0, 'Pending payment' PAID = 1, 'Payment received' FAILED = 2, 'Payment failed' payment_status = models.IntegerField(choices=PaymentStatus.choices) ``` 这样做的好处是可以让数据更加清晰易读，在模板渲染或API响应里可以直接获取人类可读的文字说明而不仅仅是原始数值。 #### 使用场景实例 当处理像订单支付状态这样的业务逻辑时，采用 `choices` 参数配合 `models.Choices` 可使代码更具有表达力和健壮性。例如，判断某个订单是否已经完成付款变得简单直观： ```python if order.payment_status == order.PaymentStatus.PAID: print("This order has been paid.") else: print(f"The current status is {order.get_payment_status_display()}.") ``` 这里不仅可以通过比较常量来进行条件分支控制，还可以调用 `get_FOO_display()` 方法获得对应中文本表示形式用于展示目的。