如何自定义Django表单中外键字段的默认提示文本？

Django表单中外键字段默认的空提示文本为“---------”，要替换为自定义内容，主要有两种常用方式：

1. 在表单类中直接配置empty_label #

方法一：通过表单初始化方法设置 #

在你的Forms.py的表单类中，重写__init__方法，给目标外键字段指定自定义的empty_label：

from django import forms
from .models import Prestamo, Computador

class PrestamoForm(forms.ModelForm):
    class Meta:
        model = Prestamo
        fields = ['computador', 'otro_campo']  # 替换为你的实际字段

    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        # 将外键字段computador的空提示改为自定义文本
        self.fields['computador'].empty_label = "选择电脑序列号"

方法二：直接定义ModelChoiceField字段 #

如果需要更明确的字段配置，可以直接在外键字段的定义中指定empty_label：

from django import forms
from .models import Prestamo, Computador

class PrestamoForm(forms.ModelForm):
    # 直接定义外键字段并设置空提示
    computador = forms.ModelChoiceField(
        queryset=Computador.objects.all(),
        empty_label="选择电脑序列号",
        label="电脑序列号"  # 可选：自定义字段标签
    )

    class Meta:
        model = Prestamo
        fields = ['computador', 'otro_campo']

2. 手动渲染模板时自定义空选项文本 #

如果你的模板是手动渲染<select>标签而非直接使用{{ form.computador }}，可以直接在空<option>中写入自定义文本：

<!-- prestamo.html 模板片段 -->
<div class="form-group">
    <label for="id_computador">电脑序列号</label>
    <select name="computador" id="id_computador" class="form-control">
        <!-- 自定义空提示选项 -->
        <option value="" selected>选择电脑序列号</option>
        {% for computador in form.computador.field.queryset %}
            <option value="{{ computador.pk }}">{{ computador.serial_number }}</option>
        {% endfor %}
    </select>
</div>

以上方法都能将默认的“---------”替换为你需要的自定义提示文本，推荐优先使用表单类配置的方式，这样能保持表单逻辑的集中管理。

内容的提问来源于stack exchange，提问作者Leonardo Carrasco Velazquez