Django表单系统详解：Form与ModelForm基础及前端渲染

月亮慢半拍

发布时间：2026-10-13 | 6人浏览过

原创

本文介绍Django中的两种核心表单类：Form与ModelForm，并对比原生HTML表单的使用差异。通过示例演示如何定义字段、处理POST请求、执行数据校验以及在前端渲染表单元素和错误信息，帮助开发者掌握Django表单处理的基本流程。

Django表单系统概述

Django提供了完善的表单处理系统，主要包含两种类型的表单类。

第一种是基于django.forms.Form基类的所有表单类的父类，适用于通用场景。
第二种是基于django.forms.ModelForm的表单类，该类可以直接与数据库模型类进行绑定，简化数据持久化操作。

原生表单与Django表单对比

此外，开发者也可以直接使用原生的HTML form表单，虽然功能完整，但相比Django内置的表单类，处理起来相对繁琐。

在Django项目中，使用form表单并非强制要求，可根据实际需求选择是否引入。

Form类定义与视图处理

在视图层（views）中，可以创建一个继承自forms.Form的类，其中定义的每个字段对应前端的一个输入控件。


#-----
#django 的form表单

from django import forms

class MyForm(forms.Form):
  #forms对应的是前端的form表单，form 表单要验证的字段
  #都与校验有关系，与数据库没有关系

  #封装性强，可以 在前端指定显示那些字段，label 是显示指定的数据，
  user = forms.CharField(label="用户名")#输入的用户名，
  age = forms.IntegerField(label="年龄")
  email = forms.EmailField()


#form注册

def reg2(request):
  # 实列化出一个form对象,传到前端

  form_obj = MyForm()

  return render(request,"reg2.html",{"form_obj":form_obj})

前端表单渲染与校验

在前端新建注册页面时，通过后端传递的表单类实例对象进行渲染。利用该对象调用各个字段，即可生成对应的HTML输入元素。


<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <title>Title</title>

</head>
<body>

<h3>form表单使用</h3>
<form action="/reg2/" method="post">
{#  渲染从后端传来的变量，as_p 是段落#}
  {% csrf_token %}
{#  {{ form_obj.as_p }}#}
  <p>姓名{{ form_obj.user }}</p>
  <p>年龄{{ form_obj.age }}</p>
  <p>邮箱{{ form_obj.email }}</p>

</form>

</body>

</html>

通过浏览器开发者工具检查页面元素可以发现，浏览器会自动为表单添加一些默认属性或结构。


<body>

<h3>form表单使用</h3>
<form action="/reg2/" method="post">

  <input name="csrfmiddlewaretoken" value="GyY3KE5uM7HeErOEZ8OQFwUJYQYaknrOmavdmfufBuVOHdDSWfeHDyt2pjXarGAV" type="hidden">

  <p>姓名<input name="user" required="" id="id_user" type="text"></p>
  <p>年龄<input name="age" required="" id="id_age" type="number"></p>
  <p>邮箱<input name="email" required="" id="id_email" type="email"></p>

</form>
</body>

若在前端页面随意输入并提交，浏览器会执行前端校验。需要注意的是，这部分校验是由浏览器自身完成的，而非后端逻辑。

自定义错误信息与完整流程

开发者可以自定义字段的错误提示信息及显示方式，以优化用户体验。


#django 的form表单
 
from django import forms
 
class MyForm(forms.Form):
  #forms对应的是前端的form表单，form 表单要验证的字段
  #都与校验有关系，与数据库没有关系
 
  #封装性强，可以 在前端指定显示那些字段，label 是显示指定的数据，require 是必须填写的，
  user = forms.CharField(label="用户名",min_length=5,max_length=8)#输入的用户名，
  age = forms.IntegerField(label="年龄",error_messages={"required":"必填",})
  email = forms.EmailField()
 
 
#form注册
 
def reg2(request):
 
  errors_obj = " "
  if request.method == "POST":
    form_post = MyForm(request.POST)#拿到请求的所有数据
    if form_post.is_valid():#判断数据是否合法，返回布尔值，
 
      print("data",form_post.cleaned_data)#获取数据，得到一个字典格式，
 
    #添加数据库
    # User.objects.create_user()
  # 实列化出一个form对象,传到前端
 
    #如果是输入不合格式的信息，错误信息，
    else:
      #获取错误信息
      errors_obj = form_post.errors
 
      # print("error",form_post.errors["user"][0])
      # print("error",form_post.errors["age"])
      # print("error",type(form_post.errors))#字典类型，
 
 
  form_obj = MyForm()
 
  return render(request,"reg2.html",{"form_obj":form_obj,"errors_obj":errors_obj})

在前端页面中，需要正确引用后端传递的表单对象及错误信息变量。


<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <title>Title</title>

</head>
<body>

<h3>form表单使用</h3>
<form action="/reg2/" method="post">
{#  渲染从后端传来的变量，as_p 是段落#}
  {% csrf_token %}
{#  {{ form_obj.as_p }}#}
  <p>姓名{{ form_obj.user }} <span>{{ errors.obj.user.0 }}</span> </p>
  <p>年龄{{ form_obj.age }}<span>{{ errors.obj.age.0 }}</span></p>
  <p>邮箱{{ form_obj.email }}<span>{{ errors.obj.email.0 }}</span></p>
  <input type="submit">

</form>

</body>

</html>

以上即为Django表单系统的基本使用介绍，希望能为相关学习提供有益参考。