Flutter TextField扫码时如何实现粘贴式单行日志输出？

问题场景：

• 粘贴条码到TextField时，onChanged会一次性拿到完整条码，日志输出单行内容，比如[log] 28333242917284
• 使用安卓商品盘点设备扫码时，设备会逐字符输入条码，导致onChanged每输入一个字符就触发一次，控制台逐段输出日志，无法直接拿到完整条码

方案1：利用扫码设备的自动回车（最常用） #

大部分扫码设备会在条码末尾自动添加换行符（回车），可以通过监听TextField的onSubmitted回调获取完整条码：

TextField(
  autofocus: false,
  cursorColor: Colors.black,
  controller: controllerItems,
  textInputAction: TextInputAction.done,
  // 仅在扫码完成（触发提交动作）时执行日志输出
  onSubmitted: (String completeText) {
    log(completeText);
    // 此处替换原onChanged中的业务逻辑
  },
  // 若需保留实时输入的UI反馈，可保留onChanged但不要在此打日志
  onChanged: onSearchTextChangedItems,
)

// 原onChanged仅做必要实时处理，去掉日志输出
onSearchTextChangedItems(String text) async {
  // 实时UI反馈等逻辑
  ........
}

方案2：防抖处理（适配无自动回车的设备） #

如果扫码设备不会自动添加回车，可通过防抖延迟执行，直到输入停止后再输出完整条码：
先定义防抖工具函数：

Timer? _debounceTimer;

void debounce(VoidCallback callback, {Duration duration = const Duration(milliseconds: 300)}) {
  _debounceTimer?.cancel();
  _debounceTimer = Timer(duration, callback);
}

修改onChanged逻辑：

TextField(
  autofocus: false,
  cursorColor: Colors.black,
  controller: controllerItems,
  onChanged: onSearchTextChangedItems,
)

onSearchTextChangedItems(String text) async {
  // 输入过程中不断取消定时器，仅在输入停止300ms后输出完整内容
  debounce(() {
    log(text);
    // 处理完整条码的业务逻辑
  });
  // 实时处理逻辑（如需要）
  ........
}

方案3：固定条码长度判断（已知条码位数时使用） #

若条码为固定长度（比如14位），可判断输入长度达标后再输出日志：

onSearchTextChangedItems(String text) async {
  // 假设条码固定为14位
  if (text.length == 14) {
    log(text);
    // 处理业务逻辑
  }
  // 实时处理逻辑
  ........
}

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