Django模型枚举字段的迁移编写最佳实践

我在Django模型中通过枚举定义了字段的选项元组，代码如下：

VERSION_CHOICES = tuple(
    (v.value, v.value) for v in ForwardsUpdateEventSensitivityVersion
)
version = models.CharField(
    max_length=max(len(s[0]) for s in VERSION_CHOICES),
    choices=VERSION_CHOICES,
)

编写对应的迁移文件时，我纠结两种实现方式，想明确哪种是最佳实践：

方式一：迁移文件中直接使用枚举 #

models.CharField(
    choices=[
        tuple(
            (v.value, v.value)
            for v in ForwardsUpdateEventSensitivityVersion
        )
    ],
)

方式二：硬编码枚举值 #

models.CharField(
    choices=[("V1", "V1"), ("V2", "V2")],
)

两种方式的优劣分析 #

• 方式一的问题：迁移文件是Django追踪数据库结构变更的核心，必须保证独立性与稳定性。如果迁移依赖外部的枚举类，后续枚举被修改、移动或删除时，历史迁移会直接报错，导致数据库迁移流程中断。Django迁移系统执行时直接读取迁移文件内容，依赖外部逻辑完全违背了迁移的设计原则。

• 方式二的优势：直接在迁移文件中写死枚举的实际值，确保了迁移文件的独立性——无论后续枚举类如何变化，历史迁移都能正常执行。这完全契合Django迁移的核心要求：每个迁移文件都应包含完整、不依赖外部的数据库结构定义。

最佳实践结论 #

优先选择硬编码枚举值的方式。

额外建议：如果想兼顾模型层的优雅与迁移的稳定性，可以使用Django 3.0+支持的TextChoices（或IntegerChoices）来绑定枚举与字段选项。例如：

from django.db import models
from django.db.models import TextChoices

class ForwardsUpdateEventSensitivityVersion(TextChoices):
    V1 = "V1", "V1"
    V2 = "V2", "V2"

version = models.CharField(
    max_length=max(len(v.value) for v in ForwardsUpdateEventSensitivityVersion),
    choices=ForwardsUpdateEventSensitivityVersion.choices,
)

这种情况下，Django自动生成的迁移文件会将choices硬编码为[("V1", "V1"), ("V2", "V2")]，既在模型层保持了枚举的清晰管理，又保证了迁移文件的独立性，无需手动编写硬编码值。

内容的提问来源于stack exchange，提问作者delighted.rock