如何在自定义Django ModelChoiceField中恢复显示help_text

这个问题我之前也碰到过！当你在ModelForm里显式声明自定义的ModelChoiceField时，Django不会自动从模型字段继承help_text属性——因为你相当于手动覆盖了该字段的默认配置，原来模型里的帮助文本就不会被自动带过来了。

有两种简单的方法可以恢复显示：

方法一：直接在字段声明时指定help_text #

你可以直接从模型字段中提取help_text，赋值给自定义字段的参数：

class EventForm(forms.ModelForm):
    category = CategoryModelChoiceField(
        queryset=Category.objects.all(),
        # 从Event模型的category字段获取原有的help_text
        help_text=Event._meta.get_field('category').help_text
    )
    class Meta:
        model = Event
        fields = [...]

这种方法最直接，适合只需要给单个字段设置的场景。

方法二：在表单__init__方法中动态设置 #

如果你的表单有多个自定义字段，或者想统一处理，可以在表单的初始化方法中给字段赋值help_text：

class EventForm(forms.ModelForm):
    category = CategoryModelChoiceField(
        queryset=Category.objects.all(),
    )
    class Meta:
        model = Event
        fields = [...]

    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        # 动态获取模型字段的help_text并赋值给表单字段
        self.fields['category'].help_text = Event._meta.get_field('category').help_text

原理说明 #

当你不手动声明category字段时，Django会根据ModelForm的Meta配置自动生成对应字段，这时候会自动继承模型字段的help_text、label等属性。但一旦你显式声明了自定义字段，就需要自己手动配置这些属性，Django不会再自动帮你继承了。

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