在Django项目开发流程中，经常会遇到需要用户填写个人信息的表单场景，比如编辑个人资料、修改收货地址等。如果表单字段能够自动填充用户已有的资料数据，就可以大幅减少用户的重复输入操作，提升整体使用体验。Django本身提供了多种灵活的表单预填充机制，能够很方便地实现从用户资料获取数据并填充到表单字段的需求。
核心实现原理
Django表单的预填充本质上是在表单实例化阶段，为表单字段的initial属性赋值。这个初始值会优先显示在表单的输入框、下拉框等组件中，用户可以直接修改，也可以直接使用预填充的内容。对于用户资料相关的预填充，核心就是先获取到当前登录用户的资料对象，再将其对应字段的值赋给表单的初始数据。
具体实现方式
方式一：视图中直接传入初始数据
这是最基础的实现方式，在视图函数中先获取当前登录用户的资料，然后把资料字段对应的值组成字典，作为initial参数传入表单类实例化。
首先假设我们有一个用户资料模型，代码如下：
from django.db import models
from django.contrib.auth.models import User
class UserProfile(models.Model):
user = models.OneToOneField(User, on_delete=models.CASCADE)
phone = models.CharField(max_length=11, verbose_name="手机号")
address = models.CharField(max_length=200, verbose_name="收货地址")
nickname = models.CharField(max_length=50, verbose_name="昵称")
对应的表单类定义如下：
from django import forms
class UserProfileForm(forms.ModelForm):
class Meta:
model = UserProfile
fields = ['nickname', 'phone', 'address']
视图函数中的实现代码如下：
from django.contrib.auth.decorators import login_required
from django.shortcuts import render
from .models import UserProfile
from .forms import UserProfileForm
@login_required
def edit_profile(request):
# 获取当前登录用户的资料对象，不存在则创建空对象
profile, created = UserProfile.objects.get_or_create(user=request.user)
# 构造初始数据字典，键对应表单字段名
initial_data = {
'nickname': profile.nickname,
'phone': profile.phone,
'address': profile.address
}
# 实例化表单时传入初始数据
form = UserProfileForm(initial=initial_data)
return render(request, 'edit_profile.html', {'form': form})
方式二：重写表单初始化方法
如果多个视图都需要用到相同的预填充逻辑，可以把获取用户资料并赋值初始数据的逻辑放在表单类的初始化方法中，这样视图层的代码会更简洁。
修改后的表单类代码如下：
from django import forms
from .models import UserProfile
class UserProfileForm(forms.ModelForm):
def __init__(self, *args, **kwargs):
# 从关键字参数中取出当前用户对象
self.user = kwargs.pop('user', None)
super().__init__(*args, **kwargs)
# 如果用户存在，获取其资料并填充初始数据
if self.user:
profile, created = UserProfile.objects.get_or_create(user=self.user)
self.fields['nickname'].initial = profile.nickname
self.fields['phone'].initial = profile.phone
self.fields['address'].initial = profile.address
class Meta:
model = UserProfile
fields = ['nickname', 'phone', 'address']
对应的视图函数可以简化为：
from django.contrib.auth.decorators import login_required
from django.shortcuts import render
from .forms import UserProfileForm
@login_required
def edit_profile(request):
# 实例化表单时传入当前用户对象
form = UserProfileForm(user=request.user)
return render(request, 'edit_profile.html', {'form': form})
模板中渲染表单
模板中只需要正常渲染表单即可，预填充的数据会自动显示在对应的表单字段中，示例模板代码如下：
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<title>编辑个人资料</title>
</head>
<body>
<form method="post">
{% csrf_token %}
{{ form.as_p }}
<button type="submit">保存</button>
</form>
</body>
</html>
注意事项
- 预填充的初始数据不会被自动验证，用户修改后提交的数据才会走表单的验证流程。
- 如果用户资料可能不存在，一定要做好容错处理，避免出现空对象访问错误。
- 如果是修改资料的场景，也可以使用
instance参数传入用户资料对象，Django的ModelForm会自动用instance的数据填充表单，不需要手动设置initial，示例：form = UserProfileForm(instance=profile)。