在Web应用中，表单是用户与服务器交互的核心方式之一——比如登录、注册、提交反馈等场景都需要表单。Flask本身不直接提供表单处理功能，但通过扩展库Flask-WTF（基于WTForms），可以轻松实现表单创建、数据验证和安全处理。本文将从零开始，一步步带你掌握Flask中表单处理与验证的核心知识。
一、环境准备：安装必要库¶
首先确保安装了Flask和Flask-WTF。打开终端，执行以下命令：
pip install flask flask-wtf
Flask：Web框架基础。Flask-WTF：Flask的表单扩展，内置了WTForms（强大的表单处理库）和CSRF保护（防止跨站请求伪造攻击）。
二、核心概念：表单类与验证器¶
我们通过表单类定义表单结构和验证规则，每个字段（如用户名、密码）对应一个类属性，每个属性可以附加多个验证器（如非空、邮箱格式、长度限制等）。
1. 定义表单类¶
以“用户注册”表单为例，创建一个RegistrationForm类，继承FlaskForm（Flask-WTF的基类）。每个字段通过StringField、PasswordField等类型定义，并用validators参数添加验证规则。
from flask_wtf import FlaskForm
from wtforms import StringField, PasswordField, SubmitField
from wtforms.validators import DataRequired, Email, Length, EqualTo
class RegistrationForm(FlaskForm):
# 用户名：非空，长度4-20
username = StringField('用户名',
validators=[DataRequired(), Length(min=4, max=20)])
# 邮箱：非空，格式验证
email = StringField('邮箱',
validators=[DataRequired(), Email()])
# 密码：非空，长度8-20
password = PasswordField('密码',
validators=[DataRequired(), Length(min=8, max=20)])
# 确认密码：与密码一致，非空
confirm_password = PasswordField('确认密码',
validators=[DataRequired(), EqualTo('password',
message='两次密码输入不一致')])
# 提交按钮
submit = SubmitField('注册')
关键说明：
- StringField：普通文本输入框（如用户名、邮箱）。
- PasswordField：密码输入框（自动隐藏输入内容）。
- SubmitField：提交按钮。
- validators：验证器列表，每个验证器负责检查字段的合法性：
- DataRequired()：字段不能为空。
- Email()：验证邮箱格式。
- Length(min, max)：限制字符串长度。
- EqualTo('field')：确保与指定字段值一致（如确认密码）。
三、在Flask中渲染表单¶
定义好表单类后，需要在视图函数中实例化表单，并在模板中渲染。
1. 视图函数处理表单¶
在app.py中定义视图函数，处理GET/POST请求：
from flask import Flask, render_template, redirect, url_for, flash
from forms import RegistrationForm # 导入表单类
app = Flask(__name__)
app.config['SECRET_KEY'] = 'your-secret-key-here' # 用于CSRF保护，需随机字符串
@app.route('/register', methods=['GET', 'POST'])
def register():
form = RegistrationForm() # 实例化表单类
if form.validate_on_submit(): # 检查是否为POST请求且数据合法
# 数据合法：获取表单数据（如form.username.data）
username = form.username.data
email = form.email.data
password = form.password.data
# 这里可添加后续操作（如存入数据库）
flash('注册成功！') # 提示信息（需在模板中显示）
return redirect(url_for('index')) # 重定向到首页
return render_template('register.html', form=form) # 渲染模板，传入表单
if __name__ == '__main__':
app.run(debug=True)
2. 模板渲染表单（register.html）¶
使用Jinja2模板语法渲染表单，需注意：
- form.hidden_tag()：生成CSRF令牌（Flask-WTF自动添加，防止恶意提交）。
- 显示字段标签、输入框和错误信息。
<!DOCTYPE html>
<html>
<head>
<title>注册</title>
</head>
<body>
<h1>用户注册</h1>
<!-- 显示提示信息 -->
{% with messages = get_flashed_messages() %}
{% if messages %}
{% for message in messages %}
<div style="color: green;">{{ message }}</div>
{% endfor %}
{% endif %}
{% endwith %}
<!-- 渲染表单 -->
<form method="POST">
{{ form.hidden_tag() }} <!-- 必须添加，否则CSRF验证失败 -->
<!-- 用户名 -->
<div>
{{ form.username.label }} <!-- 标签 -->
{{ form.username(size=32) }} <!-- 输入框 -->
<!-- 显示错误信息 -->
{% for error in form.username.errors %}
<span style="color: red;">{{ error }}</span>
{% endfor %}
</div>
<!-- 邮箱 -->
<div>
{{ form.email.label }}
{{ form.email(size=64) }}
{% for error in form.email.errors %}
<span style="color: red;">{{ error }}</span>
{% endfor %}
</div>
<!-- 密码 -->
<div>
{{ form.password.label }}
{{ form.password(size=32) }}
{% for error in form.password.errors %}
<span style="color: red;">{{ error }}</span>
{% endfor %}
</div>
<!-- 确认密码 -->
<div>
{{ form.confirm_password.label }}
{{ form.confirm_password(size=32) }}
{% for error in form.confirm_password.errors %}
<span style="color: red;">{{ error }}</span>
{% endfor %}
</div>
<!-- 提交按钮 -->
<div>{{ form.submit() }}</div>
</form>
</body>
</html>
四、处理表单提交与验证¶
当用户提交表单时，Flask-WTF会自动完成以下步骤：
1. 检查请求方法是否为POST。
2. 验证CSRF令牌（防止伪造请求）。
3. 运行所有validators检查数据合法性。
4. 若所有验证通过，form.validate_on_submit()返回True，可处理数据。
关键流程¶
- GET请求：渲染空表单（用户首次访问）。
- POST请求：
- 若验证通过：获取数据（
form.xxx.data），执行后续操作（如存入数据库）。 - 若验证失败：模板中显示错误信息（通过
form.xxx.errors循环输出）。
五、完整示例：从表单到数据库¶
若需将用户数据存入数据库，可结合SQLAlchemy（Flask的ORM扩展）。这里简化示例，假设已安装flask-sqlalchemy：
from flask_sqlalchemy import SQLAlchemy
app = Flask(__name__)
app.config['SQLALCHEMY_DATABASE_URI'] = 'sqlite:///users.db'
db = SQLAlchemy(app)
class User(db.Model):
id = db.Column(db.Integer, primary_key=True)
username = db.Column(db.String(20), unique=True, nullable=False)
email = db.Column(db.String(120), unique=True, nullable=False)
password = db.Column(db.String(20), nullable=False)
@app.route('/register', methods=['GET', 'POST'])
def register():
form = RegistrationForm()
if form.validate_on_submit():
# 检查用户名/邮箱是否已存在（可选）
existing_user = User.query.filter_by(username=form.username.data).first()
if existing_user:
flash('用户名已存在！')
return redirect(url_for('register'))
# 创建新用户并保存
new_user = User(
username=form.username.data,
email=form.email.data,
password=form.password.data # 实际项目中需加密存储
)
db.session.add(new_user)
db.session.commit()
flash('注册成功！')
return redirect(url_for('index'))
return render_template('register.html', form=form)
六、总结¶
Flask表单处理的核心步骤：
1. 定义表单类：用FlaskForm和WTForms字段，添加验证器。
2. 视图函数处理：实例化表单，判断请求方法，验证数据。
3. 模板渲染：用form.hidden_tag()生成CSRF令牌，显示字段和错误信息。
4. 数据处理：验证通过后，获取数据并执行后续操作（如数据库存储）。
通过WTForms的验证器，可轻松实现非空、格式、长度等校验，结合Flask-WTF的CSRF保护，能快速构建安全可靠的表单系统。
提示：初学者可先从简单场景（如登录表单）入手，逐步掌握复杂验证（如文件上传、多字段关联）。Flask-WTF文档（https://flask-wtf.readthedocs.io/）和WTForms文档（https://wtforms.readthedocs.io/）是进阶学习的好资源。