Django Forms下拉列表如何显示外键关联表的文本字段值

Django模型类如果没有手动定义__str__方法，默认生成的对象字符串格式为模型类名 object (主键ID)，这就是下拉框显示异常的根源：ModelChoiceField默认调用每个选项对象的__str__方法生成下拉展示文本。你现在表单提交能正常存值，说明外键关联逻辑本身没问题，只是显示层没配置对。

两种方案按需选择即可：

方案1：修改InstrumentType模型的__str__方法（全局生效，推荐） #

直接在InstrumentType模型类中添加__str__方法，返回你需要展示的instrumentType文本字段内容。修改后所有用到该模型对象字符串表示的场景（后台管理、表单下拉、日志打印等）都会显示正确文本，不需要改动现有表单代码。
打开instrumenttypes/models.py，修改代码如下：

from django.db import models

class InstrumentType(models.Model):
    # 保留你原有所有字段定义，比如存储类型描述的instrumentType字段
    instrumentType = models.CharField(max_length=你定义的字段长度, verbose_name="仪器类型描述")
    # 其他原有字段...

    def __str__(self):
        # 返回下拉框需要展示的字段值
        return self.instrumentType

修改完成后重启服务，刷新页面下拉框就能正常显示类型描述文本。

方案2：仅修改当前表单的下拉显示（不影响全局） #

如果你不想修改模型的全局字符串表现，只需要当前编辑表单的下拉展示指定字段，可以直接在定义ModelChoiceField时通过label_from_instance参数指定选项显示逻辑，修改表单代码：

from django import forms
from instruments.models import Instrument
from instrumenttypes.models import InstrumentType

class EditInstrumentForm(forms.ModelForm):
    instrumenttype = forms.ModelChoiceField(
        queryset=InstrumentType.objects.all(),
        # 直接指定每个选项的显示文本为instrumentType字段值
        label_from_instance=lambda item: item.instrumentType
    )
    class Meta:
        model =  Instrument
        fields = ('instrument', 'dateAdded', 'dateRemoved', 'nickname', 'serialNo', 'status',
              'instrumenttype')

该配置仅对当前表单生效，不会影响其他位置对InstrumentType对象的引用显示。

你当前的视图代码存在两处可优化点：

• 使用带instance参数的ModelForm时，校验通过后直接调用form.save()即可自动将所有表单字段更新到绑定的模型实例，不需要手动逐字段从cleaned_data取值赋值，减少冗余代码。
• POST请求表单校验失败时，不要重新实例化一个空的表单对象，否则会丢失用户提交的内容和表单校验错误提示，直接使用当前绑定了POST数据的form对象返回即可。

优化后的视图代码参考：

def update_instrument_view(request, id):
    instrument = get_object_or_404(Instrument, id=id)
    if request.method == 'POST':
        form  = EditInstrumentForm(request.POST, request.FILES, instance=instrument)
        if form.is_valid():
            form.save()
            messages.success(request, 'Your instrument has been updated.')
            return redirect('instrument_details', instrument.id)
        messages.error(request, 'Issue updating data.')
    else:
        form = EditInstrumentForm(instance=instrument)
    return render(request, 'instrument_update.html', {'form': form, 'instrument':instrument})

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