Django模型字段能否实现带多选功能的下拉列表？

1. Django内置功能能否实现？ #

不行。Django原生模型字段里没有直接支持「带复选框的下拉多选」的功能：

• CharField + choices 仅支持单选；
• ManyToManyField 用于关联其他模型的多选数据，默认显示为普通多选框而非下拉复选样式，且不适用于固定选项的场景；
• 官方未提供原生的、适配固定选项的下拉多选模型字段。

2. 如何仅通过模型实现？ #

要在不自定义Admin表单的前提下实现需求，需要从存储字段类型和字段绑定的Widget两方面入手：

步骤1：更换字段以支持多选存储 #

原CharField(max_length=1)只能存储单个选项值，需替换为可存储多个值的字段。推荐用JSONField（Django 3.1+支持），它能原生存储列表格式，比逗号分隔的字符串更易维护：

from django.db import models

class Customer(models.Model):
    MEMBERSHIP_BRONZE = 'B'
    MEMBERSHIP_SILVER = 'S'
    MEMBERSHIP_GOLD = 'G'

    MEMBERSHIP_CHOICES = [
        (MEMBERSHIP_BRONZE, 'Bronze'),
        (MEMBERSHIP_SILVER, 'Silver'),
        (MEMBERSHIP_GOLD, 'Gold'),
    ]

    first_name = models.CharField(max_length=255)
    last_name = models.CharField(max_length=255)
    email = models.EmailField(unique=True)
    phone = models.CharField(max_length=255)
    birth_date = models.DateField(null=True)
    # 替换为JSONField，存储选中的会员类型列表，默认空列表
    membership = models.JSONField(default=list, choices=MEMBERSHIP_CHOICES)

步骤2：自定义模型字段绑定下拉复选Widget #

Django默认没有下拉复选的Widget，这里推荐用django-select2库实现（它提供了成熟的下拉多选UI）：

1. 安装依赖：

pip install django-select2

2. 在settings.py中注册应用：

INSTALLED_APPS = [
    # 其他已注册应用
    'django_select2',
]

3. 自定义模型字段，绑定ModelSelect2MultipleWidget：

from django.db import models
from django_select2.forms import ModelSelect2MultipleWidget

class MultiSelectJSONField(models.JSONField):
    def formfield(self, **kwargs):
        # 绑定下拉多选Widget到字段
        kwargs['widget'] = ModelSelect2MultipleWidget(choices=self.choices)
        return super().formfield(**kwargs)

# 更新Customer模型的membership字段
class Customer(models.Model):
    # 常量、其他字段保持不变
    membership = MultiSelectJSONField(default=list, choices=MEMBERSHIP_CHOICES)

步骤3：Admin无需额外修改 #

因为Widget已经绑定到模型字段，你的Admin注册代码可以保持原样：

from django.contrib import admin
from .models import Customer

class CustomerAdmin(admin.ModelAdmin):
    list_display = ('first_name', 'last_name', 'email', 'membership')

admin.site.register(Customer, CustomerAdmin)

无第三方库的替代方案 #

如果不想引入外部依赖，可以自定义Widget，用原生HTML+JS实现下拉复选效果：

1. 自定义Widget：

from django.db import models
from django.forms.widgets import Widget

class DropdownCheckboxWidget(Widget):
    template_name = 'dropdown_checkbox_widget.html'

    def get_context(self, name, value, attrs):
        context = super().get_context(name, value, attrs)
        context['choices'] = self.choices
        return context

# 绑定Widget到自定义模型字段
class MultiSelectJSONField(models.JSONField):
    def formfield(self, **kwargs):
        kwargs['widget'] = DropdownCheckboxWidget(choices=self.choices)
        return super().formfield(**kwargs)

2. 创建模板文件templates/dropdown_checkbox_widget.html，用HTML和JS实现下拉复选逻辑（比如用<details>元素模拟下拉，内部放置复选框列表）。

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