Django ModelChoiceField下拉框首项出现‘---------'问题排查

原因分析 #

这个--------是Django ModelChoiceField的默认空选项，当字段设置为required=False时，框架会自动添加该选项用于表示“无选择”。另外你使用values_list('product_denomination', flat=True)的方式虽然能显示数据，但不符合ModelChoiceField的设计预期——它原本需要接收模型实例的QuerySet，而非单个字段的值列表，这也是你忽略的关键细节。

解决方案 #

1. 移除默认空选项 #

如果不需要这个空选项，直接给ModelChoiceField设置empty_label=None，同时修正QuerySet为模型实例集合，通过label_from_instance指定显示字段：

class forms_bdc(forms.ModelForm):
    bdc_description_1 = forms.ModelChoiceField(
        queryset=models_products.objects.all(),
        required=False,
        empty_label=None,
        widget=forms.Select(attrs={'id': 'editable-select-2'})
    )

    def label_from_instance(self, obj):
        return obj.product_denomination

2. 自定义空选项文本 #

如果需要保留空选项但不想显示--------，可以将empty_label设置为自定义文本（比如空字符串或“请选择”）：

bdc_description_1 = forms.ModelChoiceField(
    queryset=models_products.objects.all(),
    required=False,
    empty_label="请选择",
    widget=forms.Select(attrs={'id': 'editable-select-2'})
)

3. （不推荐）改用ChoiceField #

若仅需展示字段值、不需要关联模型实例，也可以用ChoiceField手动构造选项列表，避免自动添加空选项：

bdc_description_1 = forms.ChoiceField(
    choices=[(item, item) for item in models_products.objects.values_list('product_denomination', flat=True)],
    required=False,
    widget=forms.Select(attrs={'id': 'editable-select-2'})
)

注：这种方式会丢失ModelChoiceField关联模型实例的特性，仅适合简单展示场景。

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