Flutter技术问题：如何检测键盘回车键按下事件？

首先得说，你用FocusNode检测焦点变化的方式确实能勉强实现类似效果，但存在明显局限性——比如用户点击页面其他空白区域让输入框失焦时，也会触发你写的逻辑，这就偏离了“仅识别回车键”的初衷，所以这种方式并不精准，不推荐作为主要方案。

下面给你几个更靠谱的实现方式，都是Flutter官方推荐或者更精准的方案：

方案1：用TextField自带的onSubmitted回调（最推荐） #

这是处理回车键提交最直接的方式，TextField本身提供了onSubmitted参数，专门用来响应用户按下软键盘上的“回车/完成/提交”按钮的事件，完全不会被文本变化、焦点切换这些无关操作干扰。

示例代码：

TextField(
  controller: _textEditingController,
  onSubmitted: (inputValue) {
    // 这里就是按下回车键后的逻辑，比如调用你的API
    print('用户按下回车，输入内容：$inputValue');
    _callYourTargetApi(inputValue);
  },
)

补充：iOS系统软键盘上的按钮可能显示为“完成”“前往”等不同文字，但本质都会触发这个回调，效果是一致的。

方案2：用RawKeyboardListener监听物理回车键 #

如果你的应用需要支持外接物理键盘，要监听物理回车键的按下动作，可以用RawKeyboardListener包裹TextField，直接捕获键盘事件：

示例代码：

RawKeyboardListener(
  focusNode: FocusNode(),
  onKey: (RawKeyEvent event) {
    // 只响应回车键的按下事件
    if (event is RawKeyDownEvent && event.logicalKey == LogicalKeyboardKey.enter) {
      final inputContent = _textEditingController.text;
      _callYourTargetApi(inputContent);
    }
  },
  child: TextField(
    controller: _textEditingController,
  ),
)

这种方式可以精准识别物理键盘的回车动作，不会和软键盘的其他操作混淆。

方案3：自定义TextInputFormatter（进阶场景） #

如果需要在捕获回车事件的同时，还对输入文本做一些格式处理，可以自定义TextInputFormatter，适合有特殊需求的场景：

class EnterKeySubmitFormatter extends TextInputFormatter {
  final Function(String) onEnterPressed;

  EnterKeySubmitFormatter(this.onEnterPressed);

  @override
  TextEditingValue formatEditUpdate(TextEditingValue oldValue, TextEditingValue newValue) {
    // 检测到输入了换行符（回车键触发）
    if (newValue.text.contains('\n')) {
      final cleanInput = newValue.text.replaceAll('\n', '');
      // 触发回车后的逻辑
      onEnterPressed(cleanInput);
      // 移除换行符，保持输入框内容整洁
      return TextEditingValue(
        text: cleanInput,
        selection: TextSelection.collapsed(offset: cleanInput.length),
      );
    }
    return newValue;
  }
}

使用时直接添加到TextField的inputFormatters里：

TextField(
  controller: _textEditingController,
  inputFormatters: [
    EnterKeySubmitFormatter((value) {
      _callYourTargetApi(value);
    }),
  ],
)

总结一下：优先用方案1，简单直接完全符合需求；如果要支持物理键盘就用方案2；特殊格式需求再考虑方案3。你之前的FocusNode方式容易误触发，建议替换成上面的方案～

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