如何修改Django Crispy Forms的对象字符串展示逻辑？

Django Crispy Forms 默认使用模型类的__str__方法生成字符串，来填充CheckboxSelectMultiple字段的选项标签。我希望修改这个行为：不重写__str__方法（避免产生副作用），而是用模型中自定义的@property（比如School类的label_from_instance属性）来生成选项标签。请问是否可行？如果可行，在模型、视图、表单、模板哪个环节处理符合最佳编程实践？

相关代码示例 #

models.py #

class School(models.Model):
    nice_name_for_forms = models.CharField(max_length=100)  
    @property
    def label_from_instance(self):
        return '%s' % (self.nice_name_for_forms)

views.py #

school_list = School.objects.all().values_list('id', flat=True)
form = MyForm(request.POST, school_list=school_list)

forms.py #

class MyForm(forms.ModelForm):
    class Meta:
        model = MyForm  # 注：此处应为实际关联的数据模型，而非表单类本身
        fields = '__all__'      
        labels = {'schools' : 'My Schools'}
        widgets = {'schools' : forms.CheckboxSelectMultiple()}
    def __init__(self, *args, **kwargs):
        self.school_list = kwargs.pop('school_list')        
        super().__init__(*args, **kwargs)
        self.fields['schools'].queryset = self.fields['schools'].queryset.filter(id__in=self.school_list).distinct()
        self.helper = FormHelper()
        self.helper.use_custom_control = False
        self.helper.layout = Layout(
            Row(CheckboxAllFieldCompact('schools', wrapper_class='col-4 col-md-2'))
        )

checkbox_all_field.html #

<!-- crispy/checkbox_all_field.html -->
{% load crispy_forms_field %}
{% load i18n %}
<div id="div_checkbox_all_{{ field.html_name }}" class="no-form-control control-group {{ wrapper_class }}">
    <div class="controls" style="max-height:250px;overflow:auto">
        <label for="{{ field.name_for_label }}" class="label_title inline">{{ field.label }}</label>
        <br />
        <label class="block">
            <button id="check_all_{{ field.html_name }}" type="button" class="btn btn-default btn-sm" actif="false">{% translate 'Select all' %}</button>
        </label>
        {% crispy_field field %}
    </div>
</div>

可行性说明 #

完全可行，无需修改模型的__str__方法即可实现自定义选项标签的需求。

最佳实践环节：表单层处理 #

在表单类中处理是最符合MVT架构的最佳实践——表单层专门负责表单的显示逻辑，与模型的核心业务逻辑解耦，不会干扰视图和模板的职责划分，代码也更易维护。

具体实现方式 #

有两种简洁的实现方案：

方案1：自定义ModelChoiceField子类

继承ModelChoiceField并重写label_from_instance方法，直接调用模型的自定义属性：

# forms.py
from django import forms

class CustomSchoolChoiceField(forms.ModelChoiceField):
    def label_from_instance(self, obj):
        # 调用模型中定义的自定义属性
        return obj.label_from_instance

class MyForm(forms.ModelForm):
    # 替换默认字段类型为自定义的ChoiceField
    schools = CustomSchoolChoiceField(
        queryset=School.objects.all(),
        widget=forms.CheckboxSelectMultiple(),
        label="My Schools"
    )

    class Meta:
        model = YourActualModel  # 替换为实际关联的数据模型
        fields = '__all__'

    def __init__(self, *args, **kwargs):
        self.school_list = kwargs.pop('school_list')        
        super().__init__(*args, **kwargs)
        self.fields['schools'].queryset = self.fields['schools'].queryset.filter(id__in=self.school_list).distinct()
        # 保留原有的Crispy Forms配置
        self.helper = FormHelper()
        self.helper.use_custom_control = False
        self.helper.layout = Layout(
            Row(CheckboxAllFieldCompact('schools', wrapper_class='col-4 col-md-2'))
        )

方案2：在表单初始化方法中动态赋值

如果不想新建子类，可直接在表单__init__中给字段绑定label_from_instance逻辑：

# forms.py
class MyForm(forms.ModelForm):
    class Meta:
        model = YourActualModel  # 替换为实际关联的数据模型
        fields = '__all__'      
        labels = {'schools' : 'My Schools'}
        widgets = {'schools' : forms.CheckboxSelectMultiple()}

    def __init__(self, *args, **kwargs):
        self.school_list = kwargs.pop('school_list')        
        super().__init__(*args, **kwargs)
        self.fields['schools'].queryset = self.fields['schools'].queryset.filter(id__in=self.school_list).distinct()
        
        # 动态设置选项标签的生成逻辑
        self.fields['schools'].label_from_instance = lambda obj: obj.label_from_instance
        
        self.helper = FormHelper()
        self.helper.use_custom_control = False
        self.helper.layout = Layout(
            Row(CheckboxAllFieldCompact('schools', wrapper_class='col-4 col-md-2'))
        )

为什么不选其他环节？ #

• 模型层：把表单显示逻辑塞进模型，会破坏模型单一职责原则，导致业务逻辑和显示逻辑耦合。
• 视图层：视图负责业务流程控制和数据传递，处理表单显示逻辑会让视图代码臃肿，职责混乱。
• 模板层：手动遍历渲染选项会丢失Django表单和Crispy Forms的封装优势，增加模板复杂度，后期维护成本高。

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