Flutter如何在不丢失TextField焦点的前提下完全关闭软键盘

你在build方法里直接调用SystemChannels.textInput.invokeMethod("TextInput.hide")的写法从根上就错了：build会在页面刷新、系统触发软键盘弹出等各种时机反复执行，你调用hide的时候系统还没走完软键盘弹出的流程，相当于你刚把键盘按下去，系统后面又给弹出来，下一帧build又触发hide，来回折腾就会出现键盘快速开合闪烁的问题。而且这种事后藏键盘的补丁逻辑，本来稳定性就很差。

要做到TextField不丢焦点、能正常接收扫码枪的模拟键盘输入、完全不弹软键盘，根本不用打补丁，用输入框自带的配置就能实现，无闪烁也不会丢输入：

• 先给扫码用的TextField单独创建FocusNode，跟着页面生命周期统一管理：

late final FocusNode _scanFocusNode;

@override
void initState() {
  super.initState();
  _scanFocusNode = FocusNode();
  // 页面进入后自动聚焦到扫码输入框，无需用户手动点击
  WidgetsBinding.instance.addPostFrameCallback((_) {
    _scanFocusNode.requestFocus();
  });
}

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

• 给TextField加关键配置keyboardType: TextInputType.none，这个配置会明确告知系统「当前输入框不需要唤起软键盘」，但输入焦点会完整保留，物理键盘、扫码枪传入的内容都能正常接收：

TextField(
  focusNode: _scanFocusNode,
  // 核心配置：直接阻断软键盘唤起逻辑
  keyboardType: TextInputType.none,
  // 不要设置readOnly: true或者enabled: false，会拦截物理输入，导致扫码内容缺失
  autofocus: true,
  onChanged: (scanResult) {
    // 此处直接处理扫码枪返回的结果即可
  },
  // 其余业务配置按需求正常编写
)

该方案从根源上不会触发软键盘弹出流程，完全不会出现闪烁问题，焦点始终保持在扫码输入框上，扫码输入不会丢失。

如果项目使用的Flutter版本过低，不支持TextInputType.none，也不要在build方法中直接调用hide逻辑，改为监听焦点变化，等当前帧渲染完成后再执行隐藏，避免和系统弹键盘的逻辑抢占时机：

@override
void initState() {
  super.initState();
  _scanFocusNode = FocusNode();
  _scanFocusNode.addListener(() {
    if (_scanFocusNode.hasFocus) {
      // 等当前帧渲染完成、系统即将弹出键盘时再执行隐藏，就不会出现闪烁
      WidgetsBinding.instance.addPostFrameCallback((_) {
        SystemChannels.textInput.invokeMethod("TextInput.hide");
      });
    }
  });
}

• 不要通过切换焦点到空白FocusNode的方式隐藏键盘，该方法会让TextField失去焦点，直接导致扫码枪输入无法被接收
• 不要为了隐藏键盘将TextField设为只读状态，部分安卓机型会拦截只读输入框的物理键盘输入，出现扫码内容缺字漏字的问题
• 不要在build方法中直接调用系统通道方法操作键盘，build的执行时机和频率不受业务控制，很容易和系统逻辑产生冲突

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