调用unfocus导致TextField内容被清除的问题求助

核心问题排查 #

你遇到的情况大概率是GestureDetector拦截了ListView的触摸事件，导致TextField状态意外重置，或是TextEditingController被误重复初始化（比如在build方法内创建）。

可行解决方案 #

1. 用ListView原生属性替代GestureDetector（推荐） #

Flutter 3.3+版本的ListView支持onTapOutside属性，这是官方推荐的点击外部失焦方式，不会干扰子组件状态：

ListView.builder(
  onTapOutside: (event) {
    WidgetsBinding.instance.focusManager.primaryFocus?.unfocus();
  },
  itemCount: yourItemCount,
  itemBuilder: (context, index) => yourItemWidget,
)

2. 修复GestureDetector的事件传递 #

如果必须保留GestureDetector，设置behavior: HitTestBehavior.translucent，让ListView的触摸事件正常传递：

GestureDetector(
  behavior: HitTestBehavior.translucent,
  onTap: () {
    WidgetsBinding.instance.focusManager.primaryFocus?.unfocus();
  },
  child: ListView.builder(
    itemCount: yourItemCount,
    itemBuilder: (context, index) => yourItemWidget,
  ),
)

3. 确保TextEditingController全局唯一 #

检查Controller是否在build方法内重复创建——如果是，每次组件重建都会清空内容。必须将Controller声明为State类的成员变量：

class _YourPageState extends State<YourPage> {
  final TextEditingController _textController = TextEditingController();

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

  @override
  Widget build(BuildContext context) {
    return TextField(controller: _textController);
  }
}

4. 更可靠的失焦/隐藏键盘方法 #

如果SystemChannels方式无效，可直接操作TextField的FocusNode：

// 声明FocusNode
final FocusNode _textFocusNode = FocusNode();

// 在TextField中绑定
TextField(
  focusNode: _textFocusNode,
  controller: _textController,
)

// 失焦时调用
_textFocusNode.unfocus();

验证步骤 #

1. 确认TextEditingController未在build方法内重复初始化
2. 替换GestureDetector为ListView的onTapOutside或修复其事件传递行为
3. 测试失焦操作，检查文本内容是否保留

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