Flutter键盘开合触发应用重建致TextField内容重置问题求助

问题原因 #

键盘弹出/收起触发页面重建时，TextField的输入状态会随Widget树重置，导致内容丢失。

方案1：用GlobalKey绑定Form状态（多输入场景适用） #

如果你的TextField嵌套在Form中，GlobalKey可以跨Widget重建保留Form的状态：

1. 在State类中定义GlobalKey：

final _formKey = GlobalKey<FormState>();

2. 将Form与该Key绑定，内部放置TextField：

Form(
  key: _formKey,
  child: TextField(
    decoration: const InputDecoration(hintText: "请输入内容"),
    // 其他配置项
  ),
)

页面重建时，Form会通过GlobalKey维持内部输入组件的状态，不会清空内容。

方案2：用TextEditingController管理输入（单输入场景更便捷） #

单个TextField的话，用控制器直接托管输入内容，彻底避免重建丢失：

1. 初始化TextEditingController：

final _textController = TextEditingController();

2. 绑定到TextField：

TextField(
  controller: _textController,
  decoration: const InputDecoration(hintText: "请输入内容"),
)

3. 记得在State销毁时释放控制器（防止内存泄漏）：

@override
void dispose() {
  _textController.dispose();
  super.dispose();
}

控制器独立于Widget树存储内容，无论页面是否重建，输入的文本都会保留。

额外排查点：减少不必要的页面重建 #

键盘操作触发重建，可能是布局依赖了窗口尺寸（如直接使用MediaQuery.of(context).size）。可以优化：

• 避免在build方法中做依赖上下文的计算
• 用LayoutBuilder替代直接获取窗口尺寸
• 检查父Widget是否因键盘弹出触发不必要的重绘

内容的提问来源于stack exchange，提问作者Ashish Tandon