在 Flutter 中，若需要重置包含 `TextFormField` 的表单，可以通过 `FormState` 类提供的 `reset()` 方法实现。此方法会清空所有 `FormField` 子组件的内容，包括 `TextFormField` [^5]。 为了使用 `reset()` 方法，首先需要为 `Form` 组件设置一个全局的 `GlobalKey<FormState>`。通过该键可以获取到当前表单的状态对象，并调用其 `reset()` 方法以达到清空表单的目的 [^5]。 ### 示例代码 以下是一个完整的示例，展示如何创建一个包含多个 `TextFormField` 的表单，并提供一个按钮用于触发表单重置操作： ```dart import 'package:flutter/material.dart'; void main() => runApp(MyApp()); class MyApp extends StatelessWidget { @override Widget build(BuildContext context) { return MaterialApp( home: Scaffold( appBar: AppBar(title: Text('Form Reset Example')), body: FormResetDemo(), ), ); } } class FormResetDemo extends StatefulWidget { @override _FormResetDemoState createState() => _FormResetDemoState(); } class _FormResetDemoState extends State<FormResetDemo> { final _formKey = GlobalKey<FormState>(); final _usernameController = TextEditingController(); final _emailController = TextEditingController(); void _resetForm() { _formKey.currentState?.reset(); // 清空表单内容 _usernameController.clear(); // 可选：手动清空控制器 _emailController.clear(); // 可选：手动清空控制器 } @override Widget build(BuildContext context) { return Padding( padding: const EdgeInsets.all(16.0), child: Form( key: _formKey, child: Column( children: <Widget>[ TextFormField( controller: _usernameController, decoration: InputDecoration(labelText: '用户名'), validator: (value) { if (value == null || value.isEmpty) { return '请输入用户名'; } return null; }, ), TextFormField( controller: _emailController, decoration: InputDecoration(labelText: '邮箱'), validator: (value) { if (value == null || !value.contains('@')) { return '请输入有效的邮箱地址'; } return null; }, ), SizedBox(height: 20), ElevatedButton( onPressed: _resetForm, child: Text('重置表单'), ), ], ), ), ); } } ``` ### 说明 - **`_formKey.currentState?.reset()`**：这是触发表单重置的核心逻辑。它将清空所有 `FormField` 的状态和值。 - **`TextEditingController.clear()`**：虽然 `_formKey.currentState.reset()` 会清空字段内容，但如果使用了 `TextEditingController`，建议也手动调用 `clear()` 来确保数据一致性 [^5]。 - **可扩展性**：如果表单中包含其他类型的 `FormField`（如 `DropdownButtonFormField` 或自定义字段），同样适用此方式重置。 通过上述方法，可以轻松实现对包含 `TextFormField` 的 Flutter 表单进行重置操作 [^3]。 ---