Flutter：扫码器输入后，通过Enter键获取文本的健壮实现方案

我遇到过一模一样的问题！扫码器的快速输入确实会让时序问题凸显出来，用固定延迟的方式太依赖设备性能了，很容易出问题。这里有两个更健壮的解决方案：

方案一：用TextFormField的onFieldSubmitted（最推荐） #

这个方法是最省心的，因为onFieldSubmitted本身就是Flutter为「提交文本」场景设计的回调——当扫码器模拟按下Enter键时，文本框已经完成了所有输入的处理，TextEditingController里肯定是完整的条码内容，完全不需要延迟。

修改你的代码如下：

class _MyHomePageState extends State<MyHomePage> {
  TextEditingController _textController = TextEditingController();
  FocusNode _textNode = FocusNode();

  // 替换原来的handleKey方法，直接处理提交的文本
  void handleSubmit(String value) {
    print('- Scanned barcode: ' + value);
    // 这里直接写条码查询的逻辑即可
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      body: Center(
        child: SizedBox(
          width: double.infinity,
          height: 300,
          // 去掉冗余的RawKeyboardListener，用TextFormField自带的回调
          child: TextFormField(
            controller: _textController,
            focusNode: _textNode,
            // 关键：添加这个提交回调
            onFieldSubmitted: handleSubmit,
          ),
        ),
      ),
    );
  }
}

为什么这个方法有效？因为扫码器发送的Enter键会触发文本框的提交动作，Flutter会确保在调用onFieldSubmitted之前，所有输入的字符都已经同步到了TextEditingController里，完美避开了时序问题。

方案二：优化RawKeyboardListener的逻辑（如果必须用键盘监听） #

如果你因为某些特殊需求必须保留RawKeyboardListener，那可以做两个核心优化：

优化点1：监听KeyUp事件而非KeyDown #

KeyDown事件是在按键按下时立即触发，此时文本框可能还没来得及处理前面的条码字符；而KeyUp事件是在按键抬起时触发，这时前面的字符已经被完全处理到controller里了。

优化点2：用addPostFrameCallback替代固定延迟 #

如果还是要用KeyDown事件，那可以通过WidgetsBinding.instance.addPostFrameCallback等待当前帧绘制完成，确保文本框已经更新了controller的内容——这比固定延迟更可靠，因为它是基于Flutter的帧周期，而非硬编码的时间。

修改后的handleKey方法：

import 'package:flutter/scheduler.dart'; // 需要导入这个库

handleKey(RawKeyEvent event) {
  var isEnter = event.logicalKey.keyId == LogicalKeyboardKey.enter.keyId || 
                event.logicalKey.keyId == 1108101563381;
  
  // 改成监听KeyUp事件
  if (event is RawKeyUpEvent && isEnter) {
    print('- Text: ' + _textController.text); // 这里就能拿到完整条码了
    // 处理查询逻辑
  }

  // 或者如果必须用KeyDown，用PostFrameCallback替代延迟：
  // if (event is RawKeyDownEvent && isEnter) {
  //   WidgetsBinding.instance.addPostFrameCallback((_) {
  //     print('- Text after frame: ' + _textController.text);
  //     // 处理查询逻辑
  //   });
  // }
}

另外还要注意：你原来的代码里RawKeyboardListener用了单独的FocusNode()，这会导致焦点冲突——TextFormField的_textNode和RawKeyboardListener的FocusNode不能同时获得焦点，所以要把RawKeyboardListener的focusNode设置成和TextFormField一样的_textNode：

RawKeyboardListener(
  focusNode: _textNode, // 和TextFormField共用同一个FocusNode
  onKey: handleKey,
  child: TextFormField(
    controller: _textController,
    focusNode: _textNode,
  ),
)

总结 #

优先用方案一的onFieldSubmitted，它是Flutter官方推荐的处理文本提交的方式，完全适配扫码器这种快速输入的场景；如果必须用键盘监听，就用KeyUp事件或者PostFrameCallback，比固定延迟可靠得多。

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