Django 表单在处理 POST 数据时，forms.Form 是一个绕不开的基础组件。它不绑定数据库，只负责前端传什么、后端校验什么、清洗成什么。以下是一些关键要点，希望能帮你避开常见陷阱。
怎么写一个能接收 POST 数据的 forms.Form
说白了就是直接继承 forms.Form，字段定义和模型无关，纯靠手动声明。它不绑定数据库，只管「前端传什么、后端校验什么、清洗成什么」。
但新手最容易犯的一个错误是字段名没写对，导致 request.POST 里的键对不上，form.is_valid() 永远返回 False 却不报错——因为 Django 默认静默忽略缺失字段，除非你设了 required=True（默认就是 True）。
- 字段名必须和 HTML 表单的
name属性完全一致（大小写、下划线都不能差） - 如果前端传的是空字符串，而字段类型是
forms.IntegerField，会触发验证失败，不是类型转换异常，而是ValidationError forms.CharField默认允许空格开头/结尾，但strip=True（默认）会自动去掉，别指望它保留前后空格
class ContactForm(forms.Form):
name = forms.CharField(max_length=100)
email = forms.EmailField()
message = forms.CharField(widget=forms.Textarea)
is_valid() 返回 False 时，怎么知道哪里错了
并不是所有失败都会直接抛异常，Django 的处理方式更温和：它把错误收在 form.errors 里，是个字典：{'email': ['Enter a valid email address.'] }。注意，它只在 is_valid() 调用后才生成，没调就访问会报 AttributeError。
另一个容易踩的坑是：在模板里用 {{ form.email.errors }} 渲染时，如果字段没提交或为空，它可能显示空，不是因为没错，而是因为你没触发验证（比如忘了调 is_valid()）。
- 必须先调
form = ContactForm(request.POST)，再调form.is_valid()，两步不能省 form.errors是dict，但它的值是ErrorList类型，不是普通 list，所以if form.errors['email']:可以用，但form.errors['email'][0]才是字符串- 如果想看完整原始数据（比如调试），打印
form.data，它是QueryDict，不是request.POST的拷贝，但行为一致
Django 表单怎么和 HTML 表单联动不漏字段
关键就在于 name 和 value 的对应关系：Django 表单渲染出的字段，name 自动匹配定义的字段名；但如果你手写 HTML，就必须严格对齐，否则数据进不来。
但新手最容易犯的一个错误是前端用了 id 当提交键名，或者加了多余前缀（比如 user_name 对应后端 name 字段），或者用了 input type="button" 而不是 submit，导致整个表单根本没提交。
- 用
{{ form.name }}渲染字段最省事，它自动带name="name"和初始值（如果有） - 如果手写 HTML，
必须和email = forms.EmailField()字段名一致 - 勾选类字段（
CheckboxInput、MultipleChoiceField）没选中时，浏览器根本不会发这个 key，所以后端收到的是空 dict，不是False或[]
为什么 cleaned_data 里有时拿不到字段值
cleaned_data 这个东西，只有在 is_valid() == True 之后才存在，而且只包含通过验证的字段。哪怕某个字段只是格式错了一点（比如邮箱少个 @），它就不会进 cleaned_data，哪怕其他字段全对。
另一个稍复杂一点的情况是：自定义 clean_ 方法里抛异常，会阻止该字段进入 cleaned_data；而 clean() 方法里抛异常，整个表单失效，cleaned_data 为空。
- 不要在视图里假设
form.cleaned_data总有值，必须先判断if form.is_valid(): cleaned_data里的值已经是 Python 类型（比如int、datetime），不是字符串，别再手动转- 如果字段有
required=False，但用户没填，它也不会出现在cleaned_data里——Django 认为“未提交”不等于“提交了空值”
整体来看，Django 表单验证链条并不长，但每一步断掉都可能无声无息。最容易卡住的地方，就是以为数据已经传过来了，其实根本没通过验证。
