Flutter技术问题：实现返回键失焦TextField并修复对话框自动聚焦

一、处理返回键收起键盘需求 #

使用WillPopScope组件拦截返回事件，根据焦点状态决定是否收起键盘：

WillPopScope(
  onWillPop: () async {
    // 判断当前是否有激活的焦点
    if (FocusScope.of(context).hasFocus) {
      FocusScope.of(context).unfocus();
      // 返回false，阻止默认的页面返回行为
      return false;
    }
    // 无焦点时执行默认返回逻辑
    return true;
  },
  child: GestureDetector(
    onTap: () => FocusScope.of(context).unfocus(),
    child: Scaffold(
      body: TextField(
        controller: searchC,
        decoration: InputDecoration(
          labelText: "Search...",
          suffixIcon: Icon(Icons.search),
        ),
      ),
    ),
  ),
)

二、解决关闭对话框后TextField自动获焦的问题 #

这个问题是因为对话框弹出前TextField持有焦点，关闭后系统自动恢复焦点导致的，可通过两种方式修复：

方式1：打开对话框前主动失焦 #

调用对话框时先取消TextField的焦点：

// 示例打开对话框的代码逻辑
onPressed: () {
  FocusScope.of(context).unfocus();
  showDialog(
    context: context,
    builder: (context) => AlertDialog(
      title: const Text("Dialog"),
      actions: [
        TextButton(
          onPressed: () => Navigator.pop(context),
          child: const Text("Close"),
        ),
      ],
    ),
  );
}

方式2：绑定FocusNode手动管理焦点 #

自定义FocusNode来精准控制TextField的焦点状态：

// 在State类中定义FocusNode
final FocusNode _searchFocusNode = FocusNode();

// 页面销毁时释放资源
@override
void dispose() {
  _searchFocusNode.dispose();
  super.dispose();
}

// TextField关联自定义FocusNode
TextField(
  controller: searchC,
  focusNode: _searchFocusNode,
  decoration: InputDecoration(
    labelText: "Search...",
    suffixIcon: Icon(Icons.search),
  ),
)

// 打开对话框时取消焦点
onPressed: () {
  _searchFocusNode.unfocus();
  showDialog(...);
}

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