Django如何在UpdateView的ModelForm中使用自定义表单字段

问题核心原因 #

1. 你的CustomUserProfileForm的Meta.fields配置中没有包含pronouns字段，ModelForm默认只会自动同步fields列表内的字段值到关联模型实例，你额外定义的pronouns表单字段不会被纳入自动保存逻辑。
2. 你在form_valid中手动修改request.user的逻辑存在冲突：调用super().form_valid(form)时会执行form.save()，而视图默认通过URL参数获取要更新的用户实例，和你操作的request.user可能不是同一个对象；就算是同一个对象，表单没有把pronouns纳入字段列表，form.save()会用实例原本的旧值覆盖你刚修改的pronouns内容，这也是你修改不生效的直接原因。

正确实现方案 #

1. 调整表单配置（forms.py）

把pronouns加入Meta.fields列表，ModelForm会自动完成字段和模型的映射，无需手动处理保存逻辑：

class CustomUserProfileForm(forms.ModelForm):
    # 如需自定义label、校验规则可以保留这行，否则可省略，ModelForm会自动读取模型配置
    pronouns = forms.CharField(label='Pronouns', required=True)

    class Meta:
        model = get_user_model()
        # 新增pronouns到字段列表
        fields = ('first_name', 'last_name', 'pronouns')

    def __init__(self, *args, **kwargs):
        _pronoun_list = ('he/him/his', 'she/her/hers', 'they/them/theirs')
        super(CustomUserProfileForm, self).__init__(*args, **kwargs)
        self.fields['pronouns'].widget = ListTextWidget(
            data_list=_pronoun_list, name='pronoun-list')

2. 调整视图逻辑（views.py）

删除手动保存pronouns的冗余代码，重写get_object方法确保用户只能修改自己的资料，也无需在URL中传递用户ID参数：

class CustomUserProfileview(UpdateView):
    form_class = CustomUserProfileForm
    template_name = 'account/customuser_change_form.html'
    success_url = reverse_lazy('home')

    def get_object(self, queryset=None):
        # 直接返回当前登录用户作为要更新的实例
        return self.request.user

修改完成后表单所有字段都会自动同步保存到当前登录用户的资料中，完全符合UpdateView的设计逻辑。

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