Django模型如何定义字段存储二维数组类型数据

根据项目使用的数据库类型，可选择以下两种最优实现方式：

方案1：通用JSONField（全数据库兼容，首推） #

Django 3.1及以上版本内置的JSONField原生支持PostgreSQL、MySQL 5.7+、SQLite 3.9.0+，无需额外依赖，可直接存储嵌套数组/对象结构，支持JSON路径查询，适配绝大多数项目场景。

字段定义方式：

from django.db import models

class ScheduleClassification(models.Model):
    vendor_id = models.ForeignKey(Vendor, on_delete=models.CASCADE, default=None, null=True)
    id = models.IntegerField(primary_key=True)
    name = models.CharField(max_length=100)
    description = models.CharField(max_length=1000)
    start_date = models.DateField(auto_now_add=True)
    end_date = models.DateField(auto_now_add=True)
    duration = models.CharField(max_length=20, default="forever")
    day_type = models.CharField(max_length=20)
    # 直接定义JSONField，默认值为空列表
    time = models.JSONField(default=list, verbose_name="时间段配置")

使用方式和原生Python列表完全一致，无需额外序列化/反序列化操作：

# 写入数据
schedule_obj = ScheduleClassification.objects.create(
    vendor_id=target_vendor,
    name="Amit的排班",
    description="常规工作日排班",
    day_type="workday",
    time=[["9:00am", "2:00pm"], ["2:00pm","6:00pm"], ["6:00pm", "9:00pm"]]
)

# 读取数据直接得到二维列表
print(schedule_obj.time)
# 输出：[['9:00am', '2:00pm'], ['2:00pm', '6:00pm'], ['6:00pm', '9:00pm']]

如果需要限制数据格式，可以在模型clean方法或者接口序列化器层加校验规则，确保存入的每个子数组都是长度为2的合法时间字符串。

方案2：PostgreSQL专用ArrayField（性能最优） #

如果项目使用PostgreSQL数据库，可使用Django内置的嵌套ArrayField，相比JSONField有更强的结构约束，数组元素查询性能更高。

字段定义方式：

from django.db import models
from django.contrib.postgres.fields import ArrayField

class ScheduleClassification(models.Model):
    # 其余通用字段和方案1一致
    # 定义二维数组字段
    time = ArrayField(
        ArrayField(
            models.CharField(max_length=10), # 适配"9:00am"格式的时间字符串长度
            size=2 # 强制每个子数组固定为2个元素（开始时间、结束时间）
        ),
        default=list,
        verbose_name="时间段配置"
    )

该方案会在数据库层做结构校验，非法格式的数据无法写入，数据一致性更强。

避坑说明 #

• 不要用普通TextField手动做JSON序列化/反序列化：无格式校验、查询困难，极易出现脏数据
• 无需为该字段单独拆分关联表：如果时间段数据不需要和其他业务做关联、不需要单独建索引，拆表只会增加联表查询开销，没有实际收益

内容的提问来源于stack exchange，提问作者Mukul