在 Django 的表单处理中，cleaned_data 是一个非常重要的概念，它是 表单验证 和 数据清洗 过程后的结果。具体来说，cleaned_data 是一个字典，包含了用户通过表单提交的数据，并且经过了 Django 的表单验证器和清洗器的处理。

1. 表单验证与清洗

在 Django 中，表单（Form）的主要作用之一是验证和清理用户输入的数据。cleaned_data 是经过表单的 clean() 方法和每个字段的 clean() 方法处理后的最终结果。

• 验证：首先，Django 会检查表单中的每个字段是否满足定义的约束条件（例如，是否为必填字段、字段类型是否正确、是否满足最大长度等）。
• 清洗：验证通过后，Django 会对字段的数据进行处理或转换。例如，将字符串的日期转换为 datetime 对象，或者将输入的文本去除多余的空格。

2. cleaned_data 的形成

当你在视图中调用 form.is_valid() 时，Django 会对表单进行验证。如果验证通过，form.cleaned_data 将包含所有经过验证和清洗后的数据。如果验证失败，form.errors 会包含错误信息，而 cleaned_data 则为空。

示例：定义一个表单并访问 cleaned_data

假设我们有一个简单的表单来处理用户的姓名和年龄：

from django import forms

class UserForm(forms.Form):
    name = forms.CharField(max_length=100)
    age = forms.IntegerField(min_value=18)

    def clean_age(self):
        # 自定义的字段清理方法
        age = self.cleaned_data['age']
        if age < 18:
            raise forms.ValidationError("年龄必须大于等于18岁")
        return age

在视图中使用表单：

from django.shortcuts import render
from .forms import UserForm

def user_view(request):
    if request.method == "POST":
        form = UserForm(request.POST)
        if form.is_valid():
            # 通过验证并清洗的数据
            cleaned_data = form.cleaned_data
            name = cleaned_data['name']
            age = cleaned_data['age']
            return render(request, 'user_success.html', {'name': name, 'age': age})
        else:
            return render(request, 'user_form.html', {'form': form})
    else:
        form = UserForm()
    return render(request, 'user_form.html', {'form': form})

3. cleaned_data 的详细解释

• 验证后的数据：在表单通过 is_valid() 方法验证后，cleaned_data 就会包含所有有效的数据，并且所有字段数据都已经过了验证规则的检查。
• 字段清理后的数据：每个字段的数据（如果需要）可能已经过自定义的清理方法（例如，clean_name() 或 clean_age()）进行处理。这个过程包括转换数据类型、清理数据（如去除空格）等。

例如：

• 对于一个 CharField 字段，cleaned_data['name'] 可能已经被修剪了多余的空格。
• 对于 DateField 字段，cleaned_data['birth_date'] 可能已经被转换为 Python 的 datetime.date 对象。
• 对于 IntegerField 字段，cleaned_data['age'] 可能已经被验证为整数，并且如果需要，还会经过自定义的清理方法进行调整。

4. 如何访问 cleaned_data

在视图中，当你调用 form.is_valid() 后，可以通过 form.cleaned_data 访问清洗后的数据。cleaned_data 是一个字典，其中的键是表单字段的名称，值是字段的清洗后数据。

示例：

if form.is_valid():
    # 获取经过清洗和验证的数据
    cleaned_data = form.cleaned_data

    # 获取字段的数据
    name = cleaned_data['name']
    age = cleaned_data['age']

    # 进一步操作，例如保存到数据库

5. 常见的清洗方法

Django 表单中，每个字段都有一个 clean() 方法，通常用来清洗字段数据。你也可以通过在表单类中定义一个自定义的 clean_<fieldname>() 方法来对某个字段进行自定义的验证和清洗。

示例：自定义字段清洗

class UserForm(forms.Form):
    name = forms.CharField(max_length=100)
    age = forms.IntegerField(min_value=18)

    def clean_name(self):
        # 自定义的字段清理方法
        name = self.cleaned_data['name']
        if " " in name:
            raise forms.ValidationError("姓名不能包含空格")
        return name

在上面的例子中，clean_name() 会验证 name 字段是否包含空格，如果包含空格，则抛出验证错误。如果没有错误，name 字段会被返回清洗后的数据。

6. cleaned_data 与 form.cleaned_data 的关系

cleaned_data 是 form.cleaned_data 的最终结果，它是表单验证成功后的数据。你可以在视图中通过 form.cleaned_data 访问 cleaned_data，这个字典中包含了所有经过验证和清洗的字段数据。

7. 总结

• cleaned_data 是 Django 表单验证后清洗的数据字典，包含了所有字段的数据（如果通过验证）。
• cleaned_data 是字段数据经过验证、清理和转换后的结果，适合直接使用，例如保存到数据库。
• cleaned_data 是一个字典，键是字段名，值是清洗后的字段数据。
• 你可以在表单类中自定义 clean_<fieldname>() 方法来执行字段的额外验证和清洗操作。

通过 cleaned_data，你可以安全地使用用户输入的数据，而不需要担心数据格式问题，因为 Django 已经对它进行了验证和清洗。