如何在 Django 模板中为表单字段预填充用户数据

在 django 模板中无法直接通过 {{ profile_form.first_name }} 设置字段值；正确做法是在视图中初始化表单时传入 initial 参数或绑定实例（如 instance=user.profile），从而实现字段的动态预填充。

在 Django 中，表单字段的初始值必须在 Python 层（即视图）中设定，而非 HTML 模板中。模板仅负责渲染已配置好的表单对象，不支持运行时赋值（例如 {{ profile_form.first_name.value="John" }} 是无效语法）。

✅ 正确做法：在视图中预填充数据

方式 1：使用 initial（适用于新建/非绑定表单）

# views.py
def profile_edit(request):
    initial_data = {
        'first_name': request.user.first_name,
        'email': request.user.email,
    }
    form = ProfileForm(initial=initial_data)
    return render(request, 'profile/edit.html', {'profile_form': form})

方式 2：使用 instance（推荐，适用于编辑已有模型实例）

# views.py
def profile_edit(request):
    profile = request.user.profile  # 假设 OneToOne 关联 Profile 模型
    if request.method == 'POST':
        form = ProfileForm(request.POST, instance=profile)
        if form.is_valid():
            form.save()
            return redirect('profile_view')
    else:
        form = ProfileForm(instance=profile)  # 自动读取字段当前值
    return render(request, 'profile/edit.html', {'profile_form': form})

此时模板中只需标准渲染：

有道翻译AI助手

有道翻译提供即时免费的中文、英语、日语、韩语、法语、德语、俄语、西班牙语、葡萄牙语、越南语、印尼语、意大利语、荷兰语、泰语全文翻译、网页翻译、文档翻译、PDF翻

下载

  {% csrf_token %}
  {{ profile_form.first_name }} {# 自动显示 user.profile.first_name 的值 #}
  {{ profile_form.email }}
  保存

⚠️ 注意事项

• initial 仅影响未绑定表单（bound=False）的初始显示，不会覆盖 POST 提交的数据，也不参与模型保存逻辑；
• instance 不仅预填充字段，还确保 save() 时更新对应数据库记录，是编辑场景的首选；
• 若字段名与用户属性不一致（如表单字段叫 fname，但想填 user.first_name），可在 initial 中显式映射；
• 切勿在模板中尝试用 value="{{ user.first_name }}" 强行注入——Django 表单会忽略该属性，且破坏表单验证与 CSRF 安全机制。

总之，保持逻辑分层：数据准备在视图，渲染展示在模板。这是 Django 表单设计的核心原则，也是保障安全与可维护性的关键。