如何复用Django Model Form并修改字段标签？

方法1：创建表单子类（推荐，代码结构清晰） #

直接基于基础表单创建子类，分别定义各自的标签，维护起来更直观：

class ProfileForm(forms.ModelForm):
    class Meta:
        model = Person
        fields = ('first_name', 'last_name', 'email')
        labels = {
            'first_name': "Student's Name",
            'last_name': "Student's Surname"
        }

class TeacherProfileForm(ProfileForm):
    class Meta(ProfileForm.Meta):
        labels = {
            'first_name': "Teacher's Name",
            'last_name': "Teacher's Surname"
        }

class StudentProfileForm(ProfileForm):
    # 继承基础类的默认标签，无需额外修改
    pass

视图中直接实例化对应表单：

def add_profile(request):
    teacher_form = TeacherProfileForm(prefix='teacher')
    student_form = StudentProfileForm(prefix='student')
    return render(request, "school/add_profile.html", {
        "teacher_form": teacher_form,
        "student_form": student_form
    })

方法2：实例化后修改字段标签（适合动态场景） #

如果不想创建子类，可在表单实例化后，直接修改fields属性下对应字段的label值——这才是表单标签的实际存储位置：

def add_profile(request):
    teacher_form = ProfileForm(prefix='teacher')
    # 直接修改字段的label属性
    teacher_form.fields['first_name'].label = "Teacher's Name"
    teacher_form.fields['last_name'].label = "Teacher's Surname"
    
    student_form = ProfileForm(prefix='student')
    
    return render(request, "school/add_profile.html", {
        "teacher_form": teacher_form,
        "student_form": student_form
    })

方法3：通过构造函数动态传递标签（灵活扩展） #

如果需要更灵活的标签配置，可以给表单添加构造参数，动态覆盖默认标签：

class ProfileForm(forms.ModelForm):
    def __init__(self, custom_labels=None, *args, **kwargs):
        super().__init__(*args, **kwargs)
        if custom_labels:
            for field_name, label_text in custom_labels.items():
                if field_name in self.fields:
                    self.fields[field_name].label = label_text

    class Meta:
        model = Person
        fields = ('first_name', 'last_name', 'email')
        labels = {
            'first_name': "Student's Name",
            'last_name': "Student's Surname"
        }

视图中传递自定义标签：

def add_profile(request):
    teacher_labels = {
        'first_name': "Teacher's Name",
        'last_name': "Teacher's Surname"
    }
    teacher_form = ProfileForm(custom_labels=teacher_labels, prefix='teacher')
    
    student_form = ProfileForm(prefix='student')
    
    return render(request, "school/add_profile.html", {
        "teacher_form": teacher_form,
        "student_form": student_form
    })

原代码报错原因 #

你尝试访问teacher_form.labels是错误的——labels是Meta类中的配置项，表单初始化时会将这些配置解析到self.fields的字段对象中，表单实例本身并没有labels属性，必须通过form.fields[字段名].label来修改标签。

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