如何在Django中创建存储有序任务序列的Sequence模型

这个问题我之前做任务编排系统时正好遇到过——默认的多对多关系是不保存顺序的，所以要实现序列的有序性，核心思路就是用自定义中间关联表来维护任务在序列中的位置，下面给你一步步拆解实现：

1. 先定义Sequence基础模型 #

首先创建Sequence本身，用来存储序列的基本信息，比如名称、描述这些：

from django.db import models

class Sequence(models.Model):
    name = models.CharField(max_length=100, unique=True, verbose_name="序列名称")
    description = models.TextField(blank=True, verbose_name="序列描述")
    created_at = models.DateTimeField(auto_now_add=True)

    def __str__(self):
        return self.name

2. 自定义中间关联表（关键！） #

接下来创建中间表，专门用来关联Sequence和Task，同时加一个position字段记录任务在序列里的顺序位置：

class SequenceTask(models.Model):
    sequence = models.ForeignKey(Sequence, on_delete=models.CASCADE, related_name="sequence_tasks")
    task = models.ForeignKey("Task", on_delete=models.CASCADE, related_name="task_sequences")
    position = models.PositiveIntegerField(verbose_name="序列中的位置", db_index=True)

    class Meta:
        # 确保同一个序列里，同一个任务不会被重复添加
        unique_together = ("sequence", "task")
        # 设置默认按position排序，这样查出来的任务就是有序的
        ordering = ["position"]

    def __str__(self):
        return f"{self.sequence.name} - {self.task.name} (位置: {self.position})"

    def save(self, *args, **kwargs):
        # 可选：校验同序列下的位置是否重复，避免冲突
        if SequenceTask.objects.filter(sequence=self.sequence, position=self.position).exclude(pk=self.pk).exists():
            raise ValueError(f"序列{self.sequence.name}中已经有位置为{self.position}的任务啦")
        super().save(*args, **kwargs)

3. 关联Sequence和Task模型 #

回到Sequence模型，添加多对多字段，指定用上面的中间表来关联Task：

class Sequence(models.Model):
    name = models.CharField(max_length=100, unique=True, verbose_name="序列名称")
    description = models.TextField(blank=True, verbose_name="序列描述")
    created_at = models.DateTimeField(auto_now_add=True)
    # 关联Task，使用自定义的中间表
    tasks = models.ManyToManyField("Task", through="SequenceTask", related_name="sequences")

    def __str__(self):
        return self.name

4. 实际使用示例 #

给序列添加有序任务 #

# 假设你已经有了Task实例：task1、task3、task7
sequence1 = Sequence.objects.create(name="sequence1")

# 逐个添加任务并指定位置
SequenceTask.objects.create(sequence=sequence1, task=task1, position=1)
SequenceTask.objects.create(sequence=sequence1, task=task3, position=2)
SequenceTask.objects.create(sequence=sequence1, task=task7, position=3)

# 批量添加更高效
SequenceTask.objects.bulk_create([
    SequenceTask(sequence=sequence1, task=task1, position=1),
    SequenceTask(sequence=sequence1, task=task3, position=2),
    SequenceTask(sequence=sequence1, task=task7, position=3)
])

获取序列中的有序任务 #

因为中间表的Meta里设置了默认按position排序，所以直接查询就能得到有序的任务列表：

sequence1 = Sequence.objects.get(name="sequence1")
# 直接获取有序任务
ordered_tasks = sequence1.tasks.all()

# 或者通过中间表查看更详细的位置信息
task_with_position = sequence1.sequence_tasks.all()

调整任务顺序 #

如果需要修改某个任务的位置，直接更新中间表的position字段就行：

# 把task3的位置改成1，task1改成2
seq_task3 = SequenceTask.objects.get(sequence=sequence1, task=task3)
seq_task3.position = 1
seq_task3.save()

seq_task1 = SequenceTask.objects.get(sequence=sequence1, task=task1)
seq_task1.position = 2
seq_task1.save()

# 现在查询sequence1的任务顺序就是task3 → task1 → task7了

额外优化小技巧 #

• 给position加了db_index=True，当序列里任务很多时，排序查询的速度会更快；
• 中间表的save方法里加了位置重复校验，避免手动添加时出现顺序冲突；
• 如果需要前端拖拽排序的功能，可以考虑用django-ordered-model这类第三方库简化逻辑，但如果不想依赖第三方包，上面的自定义方案完全够用。

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