Python Django表单怎么写？Form类基础验证与ModelForm直接关联模型数据双重校验教程

在Django项目开发中，表单是接收用户提交数据、完成数据校验的核心组件，Django提供了Form和ModelForm两种表单类，分别适用于不同的业务场景，开发者可以根据需求选择合适的实现方式。

一、Django Form类基础写法与验证

Form类是Django最基础的表单实现方式，适用于不需要直接关联模型的自定义数据收集场景，比如用户登录、搜索过滤等场景。

1.1 基础Form类定义

首先需要在应用的forms.py文件中定义表单类，继承django.forms.Form，然后声明需要的字段即可。

# forms.py
from django import forms

# 定义用户登录表单
class LoginForm(forms.Form):
    # 用户名输入框，最大长度20，标签显示为用户名
    username = forms.CharField(max_length=20, label="用户名")
    # 密码输入框，最小长度6，输入时显示为密文
    password = forms.CharField(min_length=6, label="密码", widget=forms.PasswordInput)
    # 记住登录状态复选框，默认不勾选
    remember = forms.BooleanField(required=False, label="记住登录状态")

1.2 Form类基础验证规则

Form类内置了多种基础验证规则，比如字段必填、长度限制、数据类型校验等，同时支持自定义验证方法。

常用内置验证参数包括：

• required：是否必填，默认True
• max_length/min_length：字符串长度限制
• max_value/min_value：数值范围限制
• validators：自定义验证器列表

1.3 自定义验证方法

如果需要实现复杂的校验逻辑，可以在Form类中定义以clean_字段名开头的方法，实现单字段自定义验证。

# forms.py
from django import forms
from django.core.exceptions import ValidationError

class RegisterForm(forms.Form):
    username = forms.CharField(max_length=20, label="用户名")
    password = forms.CharField(min_length=6, label="密码", widget=forms.PasswordInput)
    confirm_password = forms.CharField(min_length=6, label="确认密码", widget=forms.PasswordInput)

    # 验证确认密码和密码是否一致
    def clean_confirm_password(self):
        # 获取已经校验过的密码字段值
        password = self.cleaned_data.get("password")
        confirm_password = self.cleaned_data.get("confirm_password")
        if password and confirm_password and password != confirm_password:
            raise ValidationError("两次输入的密码不一致")
        return confirm_password

    # 验证用户名是否包含非法字符
    def clean_username(self):
        username = self.cleaned_data.get("username")
        if username and "admin" in username:
            raise ValidationError("用户名不能包含admin关键字")
        return username

1.4 Form类在视图中的使用

在视图函数中，可以通过实例化Form类接收用户提交的数据，调用is_valid()方法触发验证，通过cleaned_data获取校验后的合法数据。

# views.py
from django.shortcuts import render, HttpResponse
from .forms import RegisterForm

def register_view(request):
    if request.method == "POST":
        # 实例化表单，传入POST数据
        form = RegisterForm(request.POST)
        # 触发表单验证
        if form.is_valid():
            # 获取校验后的合法数据
            username = form.cleaned_data["username"]
            password = form.cleaned_data["password"]
            # 此处可以编写保存用户数据的逻辑
            return HttpResponse("注册成功")
    else:
        # GET请求时返回空表单
        form = RegisterForm()
    return render(request, "register.html", {"form": form})

二、ModelForm关联模型实现双重校验

当需要表单直接操作模型数据时，使用ModelForm可以减少重复代码，它会自动根据模型字段生成表单字段，同时支持模型和表单的双重验证。

2.1 ModelForm基础定义

定义ModelForm需要继承django.forms.ModelForm，在内部类Meta中指定关联的模型和需要生成的字段。

# models.py
from django.db import models

# 定义用户模型
class User(models.Model):
    username = models.CharField(max_length=20, unique=True, verbose_name="用户名")
    password = models.CharField(max_length=128, verbose_name="密码")
    email = models.EmailField(verbose_name="邮箱")
    create_time = models.DateTimeField(auto_now_add=True, verbose_name="创建时间")

    class Meta:
        verbose_name = "用户"
        verbose_name_plural = verbose_name

# forms.py
from django import forms
from .models import User

class UserModelForm(forms.ModelForm):
    # 自定义密码字段，使用密文输入
    password = forms.CharField(min_length=6, label="密码", widget=forms.PasswordInput)

    class Meta:
        # 关联的模型
        model = User
        # 需要生成的表单字段，排除create_time字段
        fields = ["username", "password", "email"]
        # 也可以指定排除的字段：exclude = ["create_time"]
        # 自定义字段的标签
        labels = {
            "username": "用户名",
            "email": "邮箱"
        }

2.2 ModelForm的双重校验逻辑

ModelForm的验证分为两层：第一层是表单层的验证，和第二层是模型层的验证。当调用is_valid()方法时，会先执行表单层的验证规则，再执行模型层的内置验证（比如unique唯一约束校验）。

如果需要在ModelForm中添加自定义验证，方式和Form类一致，可以定义clean_字段名的方法，也可以重写clean方法实现多字段联合验证。

# forms.py
from django import forms
from django.core.exceptions import ValidationError
from .models import User

class UserModelForm(forms.ModelForm):
    password = forms.CharField(min_length=6, label="密码", widget=forms.PasswordInput)
    confirm_password = forms.CharField(min_length=6, label="确认密码", widget=forms.PasswordInput)

    class Meta:
        model = User
        fields = ["username", "password", "email"]

    # 表单层验证确认密码
    def clean_confirm_password(self):
        password = self.cleaned_data.get("password")
        confirm_password = self.cleaned_data.get("confirm_password")
        if password and confirm_password and password != confirm_password:
            raise ValidationError("两次输入的密码不一致")
        return confirm_password

    # 重写clean方法实现多字段验证
    def clean(self):
        cleaned_data = super().clean()
        username = cleaned_data.get("username")
        # 模型层会自动校验username的unique约束，这里可以添加额外的业务校验
        if username and len(username) < 3:
            self.add_error("username", "用户名长度不能小于3位")
        return cleaned_data

2.3 ModelForm在视图中的使用

ModelForm支持直接保存数据到关联的模型，调用save()方法即可自动创建或更新模型实例，不需要手动处理字段赋值。

# views.py
from django.shortcuts import render, redirect
from .forms import UserModelForm

def create_user_view(request):
    if request.method == "POST":
        form = UserModelForm(request.POST)
        if form.is_valid():
            # 保存表单数据到模型，自动处理字段映射
            user = form.save()
            # 如果需要额外处理字段，可以先获取实例再修改
            # user = form.save(commit=False)
            # user.password = make_password(user.password)  # 密码加密处理
            # user.save()
            return redirect("user_list")
    else:
        form = UserModelForm()
    return render(request, "create_user.html", {"form": form})

三、Form与ModelForm的选择建议

两种表单类的适用场景如下：

在实际开发中，可以根据业务需求灵活选择，如果表单字段和模型字段高度匹配，优先使用ModelForm减少重复代码；如果是自定义的非模型数据收集，使用Form类更加灵活。

Django_FormModelForm表单验证Django模型修改时间：2026-07-02 12:45:38