Django prepopulated_fields生成Slug时如何保留特殊字符？

默认情况下Django的slugify函数会过滤掉+这类特殊字符，导致生成的slug和标题不一致。要实现标题含+时slug保留该字符，需要从自定义slug生成逻辑、修改字段验证规则、后台表单处理三个方面调整：

1. 自定义Slug生成函数 #

先写一个自定义的slug处理函数，保留允许的特殊字符（如+、-）：

# models.py
def custom_slugify(value):
    # 转为小写
    value = value.lower()
    # 空格替换为连字符
    value = value.replace(' ', '-')
    # 只保留允许的字符：小写字母、数字、-、+、_
    allowed_chars = set('abcdefghijklmnopqrstuvwxyz0123456789-+_')
    return ''.join(c for c in value if c in allowed_chars)

2. 修改Model字段与保存逻辑 #

• 给SlugField添加自定义验证器，允许+等字符
• 重写save方法，自动生成符合要求的slug，并处理重复情况：

# models.py
from django.db import models
from ckeditor_uploader.fields import RichTextUploadingField
from django.core.validators import RegexValidator

# 自定义slug验证器
custom_slug_validator = RegexValidator(
    regex=r'^[a-z0-9-+_]+$',
    message="Slug仅支持小写字母、数字、-、+和_",
    code='invalid_slug'
)

def custom_slugify(value):
    value = value.lower()
    value = value.replace(' ', '-')
    allowed_chars = set('abcdefghijklmnopqrstuvwxyz0123456789-+_')
    return ''.join(c for c in value if c in allowed_chars)

class Post(models.Model):
    titolo = models.CharField(max_length=255)
    descrizione = RichTextUploadingField('Text', config_name='default', blank=True, null=True)
    # 允许slug为空（由save方法自动生成），添加自定义验证器
    slug = models.SlugField(unique=True, blank=True, validators=[custom_slug_validator])

    def save(self, *args, **kwargs):
        # 如果slug为空，自动生成
        if not self.slug:
            self.slug = custom_slugify(self.titolo)
            # 处理slug重复问题，添加数字后缀
            counter = 1
            while Post.objects.filter(slug=self.slug).exclude(pk=self.pk).exists():
                self.slug = f"{custom_slugify(self.titolo)}-{counter}"
                counter += 1
        super().save(*args, **kwargs)

3. 调整Admin后台配置 #

默认的prepopulated_fields用的是Django原生slugify，会过滤+，所以可以通过自定义表单来确保slug生成正确，同时允许用户手动编辑：

# admin.py
from django.contrib import admin
from .models import Post
from django import forms

class PostAdminForm(forms.ModelForm):
    class Meta:
        model = Post
        fields = '__all__'

    # 清理slug字段，确保生成符合要求的slug
    def clean_slug(self):
        slug = self.cleaned_data.get('slug')
        if not slug:
            slug = custom_slugify(self.cleaned_data['titolo'])
            counter = 1
            while Post.objects.filter(slug=slug).exclude(pk=self.instance.pk).exists():
                slug = f"{custom_slugify(self.cleaned_data['titolo'])}-{counter}"
                counter += 1
        return slug

class PostAdmin(admin.ModelAdmin):
    form = PostAdminForm
    # 若需要后台实时预览slug，可自定义JS替换原生的prepopulate逻辑，否则注释掉原prepopulated_fields
    # prepopulated_fields = {'slug': ('titolo',)}

admin.site.register(Post, PostAdmin)

这样设置后，当标题为「Samsung Galaxy S24+」时，slug会自动生成「samsung-galaxy-s24+」，且支持重复标题时自动添加数字后缀（如「samsung-galaxy-s24+-1」），同时后台验证会确保slug格式符合要求。

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