Django表单Widget选型：适配get_or_create，兼具Model字段值列表与新增

嘿，这个需求我之前也碰到过！Django原生确实没有直接提供这种「既能选已有选项，又能输入新值」的Widget，但有两种非常实用的解决办法，完美适配get_or_create的逻辑：

1. 自定义混合Widget（原生实现，无需第三方库） #

自己动手把选择框和输入框拼在一起，再在表单里处理提交逻辑，完全可控。

具体步骤： #

首先写一个自定义Widget，把Select和TextInput组合成一个控件：

from django.forms import Widget, Select, TextInput
from django.utils.safestring import mark_safe

class SelectOrTextWidget(Widget):
    def __init__(self, select_widget=None, text_widget=None, attrs=None):
        self.select_widget = select_widget or Select()
        self.text_widget = text_widget or TextInput()
        super().__init__(attrs)

    def render(self, name, value, attrs=None, renderer=None):
        # 渲染已有选项的选择框
        select_html = self.select_widget.render(name, value, attrs, renderer)
        # 渲染新增值的输入框，给name加后缀避免冲突
        text_attrs = attrs.copy() if attrs else {}
        text_attrs['name'] = f"{name}_new"
        text_html = self.text_widget.render(f"{name}_new", None, text_attrs, renderer)
        # 把两个控件组合起来，加个提示文字
        return mark_safe(f"""
            <div class="select-or-text">
                {select_html}
                <br>
                <small>没找到需要的选项？直接输入新值：</small>
                {text_html}
            </div>
        """)

然后在表单里用这个Widget，并重写clean方法处理get_or_create：

from django import forms
from .models import YourModel  # 替换成你的模型

class YourForm(forms.ModelForm):
    class Meta:
        model = YourModel
        fields = ['your_field']  # 替换成你的字段
        widgets = {
            'your_field': SelectOrTextWidget(
                # 传入已有选项的下拉框配置
                select_widget=forms.Select(choices=[(obj.pk, obj.name) for obj in YourModel.objects.all()])
            )
        }

    def clean_your_field(self):
        # 获取选择框和输入框的值
        selected_pk = self.cleaned_data.get('your_field')
        new_value = self.cleaned_data.get('your_field_new')

        if new_value:
            # 用get_or_create获取或创建新对象
            obj, _ = YourModel.objects.get_or_create(name=new_value)
            return obj
        elif selected_pk:
            # 返回选中的已有对象
            return YourModel.objects.get(pk=selected_pk)
        else:
            raise forms.ValidationError("请选择或输入一个有效值")

这样用户就能自由选择已有值，或者输入新值提交，表单会自动帮你处理get_or_create的逻辑。

2. 使用Django-autocomplete-light（第三方库，更省心） #

如果不想自己写Widget，推荐用django-autocomplete-light这个库——它专门做带自动补全的选择控件，还支持直接新增值，用户体验拉满。

具体步骤： #

先安装库：

pip install django-autocomplete-light

在settings.py里把库加到INSTALLED_APPS：

INSTALLED_APPS = [
    # ... 其他app
    'dal',
    'dal_select2',
]

写一个自动补全的视图：

from dal import autocomplete
from .models import YourModel

class YourModelAutocomplete(autocomplete.Select2QuerySetView):
    def get_queryset(self):
        # 这里可以加权限控制，比如只给登录用户用
        if not self.request.user.is_authenticated:
            return YourModel.objects.none()
        # 根据用户输入的关键词过滤选项
        qs = YourModel.objects.all()
        if self.q:
            qs = qs.filter(name__icontains=self.q)
        return qs

在urls.py里配置这个视图的路由：

from django.urls import path
from .views import YourModelAutocomplete

urlpatterns = [
    # ... 其他路由
    path('your-model-autocomplete/', YourModelAutocomplete.as_view(), name='your-model-autocomplete'),
]

最后在表单里用这个库的Widget，开启新增功能：

from django import forms
from dal import autocomplete
from .models import YourModel

class YourForm(forms.ModelForm):
    your_field = forms.ModelChoiceField(
        queryset=YourModel.objects.all(),
        widget=autocomplete.ModelSelect2Widget(
            url='your-model-autocomplete',  # 对应上面配置的路由名
            attrs={
                'data-create': 'true',  # 开启新增功能
                'data-create-field': 'name',  # 指定新增时要填充的字段
            }
        )
    )

    class Meta:
        model = YourModel
        fields = ['your_field']

这个Widget会渲染一个带自动补全的输入框：用户输入时会实时匹配已有选项，要是输入的是新值，提交时会自动调用get_or_create创建新对象，完全不用自己写额外的逻辑，非常方便。

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