Flutter如何实现TextField首次自动聚焦仅隐藏一次键盘，用户手动聚焦正常弹出

你之前重写consumeKeyboardToken无效的原因是Flutter 3.0+版本调整了该方法的调用逻辑，仅用户主动触发输入的场景才会调用该方法，自动聚焦场景不会触发，所以方案失效。可使用以下两种方案实现需求：

方案1：焦点监听+系统通道控制（最简实现） #

1. 先导入系统服务包：

import 'package:flutter/services.dart';

2. 定义焦点节点和首次聚焦标记：

late final FocusNode textFieldFocusNode;
// 标记是否为页面打开后的首次自动聚焦
bool _isFirstAutoFocus = true;

@override
void initState() {
  super.initState();
  textFieldFocusNode = FocusNode();
  // 监听焦点变化
  textFieldFocusNode.addListener(() {
    if (textFieldFocusNode.hasFocus) {
      if (_isFirstAutoFocus) {
        // 首次自动聚焦隐藏键盘，加短延迟避免部分机型弹起后再隐藏的闪跳问题
        Future.delayed(const Duration(milliseconds: 30), () {
          SystemChannels.textInput.invokeMethod('TextInput.hide');
        });
        _isFirstAutoFocus = false;
      } else {
        // 后续主动聚焦正常弹出键盘
        SystemChannels.textInput.invokeMethod('TextInput.show');
      }
    }
  });
}

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

3. 原有业务代码无需大幅修改，保持autofocus=true并绑定定义好的focusNode即可：

Card(
    elevation: 1,
    child: TextField(
      autofocus: true,
      focusNode: textFieldFocusNode,
      onEditingComplete: () {
        print('Barcode: ${textController.text}');
        buttonFocusNode.requestFocus();
        events!(context);
        if (textController.text.isNotEmpty) {
          _audioCache.play('success.mp3');
        }
      },
      controller: textController,
      decoration: const InputDecoration(
          fillColor: Colors.white,
          prefixIcon: Icon(Icons.qr_code),
          hintText: 'Barcode',
          focusColor: Palette.asBlue,
          border: InputBorder.none,
          focusedBorder: InputBorder.none),
    ),
  );

方案2：自定义TextField子类（全版本兼容，无延迟闪跳） #

如果方案1在部分机型存在键盘短暂闪现的问题，可通过重写EditableText的键盘请求逻辑实现：

// 自定义不自动弹出键盘的TextField
class AutoFocusNoKeyboardTextField extends TextField {
  const AutoFocusNoKeyboardTextField({
    super.key,
    required super.controller,
    super.focusNode,
    super.decoration,
    super.autofocus,
    super.onEditingComplete,
    // 可按需补充其他TextField参数
  });

  @override
  EditableTextState createEditableTextState() {
    return _AutoFocusNoKeyboardEditableState();
  }
}

class _AutoFocusNoKeyboardEditableState extends EditableTextState {
  bool _isFirstFocus = true;

  @override
  void requestKeyboard() {
    if (_isFirstFocus) {
      _isFirstFocus = false;
      return;
    }
    super.requestKeyboard();
  }
}

使用时直接替换原有TextField为AutoFocusNoKeyboardTextField即可，无需额外的焦点监听逻辑。

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