如何使用Django ModelForm创建带预设值的select选择字段

你的代码有三个核心配置错误，导致控件未按预期渲染：

• ModelForm的Meta类中自定义控件的配置项名称是**widgets（复数形式）**，你写成了单数widget，Django无法识别该配置，所有自定义控件规则都不会加载，字段会直接使用模型默认的渲染形式（普通文本输入框）。
• 你为continent字段使用了forms.SelectMultiple控件，这是多选下拉控件，单选项选择场景需要使用forms.Select。
• 要渲染带固定预设值的选择框，必须先在模型层的continent字段上配置choices选项列表，否则选择控件没有可渲染的选项。

1. 先在模型中配置大洲预设选项 #

打开models.py，给Trip模型的continent字段添加choices配置：

from django.db import models

class Trip(models.Model):
    # 固定大洲选项，格式为(数据库存储值, 前端显示值)
    CONTINENT_CHOICES = (
        ('europe', '欧洲'),
        ('north_america', '北美洲'),
        ('south_america', '南美洲'),
        ('asia', '亚洲'),
        ('africa', '非洲'),
        ('oceania', '大洋洲'),
        ('antarctica', '南极洲'),
    )
    city = models.CharField(max_length=100, verbose_name='城市')
    country = models.CharField(max_length=100, verbose_name='国家')
    # 给continent字段绑定选项，CharField长度足够存储选项值即可
    continent = models.CharField(
        max_length=20, 
        choices=CONTINENT_CHOICES,
        verbose_name='所属大洲'
    )
    description = models.TextField(verbose_name='行程描述')
    photo = models.ImageField(upload_to='trip_images/', verbose_name='行程照片')

如果之前已经执行过数据库迁移，只要continent字段本身是CharField且长度不小于选项存储值的最大长度，添加choices不需要重新生成迁移——choices是Django框架层面的渲染、校验配置，不修改数据库表结构。

2. 修正ModelForm的控件配置 #

打开forms.py，把Meta类中的单数widget改为复数widgets，同时调整对应控件类型：

from django import forms
from .models import Trip

class TripForm(forms.ModelForm):
    class Meta:
        model = Trip
        fields = ('city', 'country', 'continent', 'description', 'photo')
        # 注意：配置项名是widgets，为复数形式
        widgets = {
            'city': forms.TextInput(attrs={'class': 'form-control'}),
            'country': forms.TextInput(attrs={'class': 'form-control'}),
            # 单选场景使用Select控件，多选场景再替换为SelectMultiple
            'continent': forms.Select(attrs={'class': 'form-control'}),
            # 长文本描述使用Textarea控件，比单行TextInput更适配
            'description': forms.Textarea(attrs={'class': 'form-control', 'rows': 4}),
            # 图片上传字段对应ClearableFileInput控件
            'photo': forms.ClearableFileInput(attrs={'class': 'form-control'}),
        }

• 如果业务需要支持单个行程关联多个大洲（比如跨洲旅行），需要把模型的continent字段改为支持多值的字段类型（如PostgreSQL的ArrayField、或多对多关联表），再保留SelectMultiple控件即可。
• 配置完成后刷新页面，continent字段会自动读取模型中定义的CONTINENT_CHOICES渲染下拉选项，不需要在表单中重复编写选项列表，Django会自动完成选项填充、提交值校验的逻辑。

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