如何为已存在的模型对象填充AutoSlugField字段？

我之前也碰到过一模一样的需求——给已经跑了好一阵的项目补加slug字段，毕竟用slug做URL参数确实比pk安全友好太多。下面是我亲测有效的完整流程：

1. 先在模型中添加AutoSlugField #

首先修改你的模型文件，新增slug字段。注意要指定populate_from来关联生成slug的源字段（比如标题title），同时暂时允许null/blank，方便后续迁移：

from django_extensions.db.fields import AutoSlugField

class YourModel(models.Model):
    # 你的已有字段，比如文章标题
    title = models.CharField(max_length=200)
    # 新增的slug字段
    slug = AutoSlugField(
        populate_from='title',  # 从title自动生成slug
        unique=True,            # 确保slug全局唯一
        allow_unicode=True,     # 支持中文等非ASCII字符（如果需要）
        null=True,              # 初始允许为空，避免迁移报错
        blank=True
    )

2. 生成并执行初始迁移 #

运行以下命令生成迁移文件并同步到数据库：

python manage.py makemigrations
python manage.py migrate

这时候数据库里的旧数据行的slug字段都是NULL，接下来要批量填充这些值。

3. 批量填充slug字段 #

有两种常用方式，根据你的场景选：

方式一：用Django Shell快速处理（适合测试环境/数据量小的情况） #

打开Django Shell：

python manage.py shell

然后执行这段代码：

from yourapp.models import YourModel

# 遍历所有没有slug的对象，调用save()触发AutoSlugField自动生成
for obj in YourModel.objects.filter(slug__isnull=True):
    obj.save()

AutoSlugField会在save时自动为无slug的对象生成唯一值，如果遇到重复的title，会自动加后缀（比如my-article、my-article-1），完全不用手动处理重复问题。

方式二：用数据迁移脚本（适合生产环境，更规范安全） #

如果是生产环境，推荐用迁移脚本的方式，避免手动操作出错：

1. 生成一个空的迁移文件：

python manage.py makemigrations yourapp --name populate_slug_fields

2. 打开生成的迁移文件，修改内容如下：

from django.db import migrations

def populate_slugs(apps, schema_editor):
    # 通过apps获取模型，避免直接导入导致的版本问题
    YourModel = apps.get_model('yourapp', 'YourModel')
    # 批量生成并保存slug
    for obj in YourModel.objects.filter(slug__isnull=True):
        obj.save()

class Migration(migrations.Migration):
    # 依赖于上一次的迁移（替换成你自己的迁移文件名）
    dependencies = [
        ('yourapp', '0002_auto_20240520_1234'),
    ]

    operations = [
        migrations.RunPython(populate_slugs),
    ]

3. 执行迁移：

python manage.py migrate

4. 可选：强化字段约束 #

填充完成后，如果你想强制后续新创建的对象必须有slug，可以修改模型中的slug字段，去掉null=True和blank=True，再生成一次迁移并执行，彻底锁死字段规则。

重要提醒 #

• 操作前一定要备份数据库，尤其是生产环境，避免数据意外丢失。
• 如果你的源字段（比如title）有大量重复内容，AutoSlugField会自动处理唯一性，无需手动干预。
• 如果你用的是原生Django的SlugField而非django-extensions的AutoSlugField，逻辑类似，但需要手动用slugify函数生成值，不过AutoSlugField显然更省心。

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