Flutter中如何让TextFormField仅接收物理键盘输入且永不弹出软键盘？

针对自带物理键盘的Android设备，要彻底禁用屏幕软键盘同时保留物理键盘输入功能，以下是几种可靠的实现方案：

方法一：自定义TextField，拦截软键盘请求并监听物理按键 #

直接使用TextInputType.none会导致无法接收输入，我们可以结合FocusNode和RawKeyboardListener来处理：

class PhysicalKeyboardTextField extends StatefulWidget {
  final ValueChanged<String>? onChanged;
  final String initialValue;

  const PhysicalKeyboardTextField({
    Key? key,
    this.onChanged,
    this.initialValue = '',
  }) : super(key: key);

  @override
  State<PhysicalKeyboardTextField> createState() => _PhysicalKeyboardTextFieldState();
}

class _PhysicalKeyboardTextFieldState extends State<PhysicalKeyboardTextField> {
  late FocusNode _focusNode;
  late TextEditingController _controller;

  @override
  void initState() {
    super.initState();
    _focusNode = FocusNode();
    _controller = TextEditingController(text: widget.initialValue);
    // 焦点获取时强制隐藏软键盘
    _focusNode.addListener(() {
      if (_focusNode.hasFocus) {
        SystemChannels.textInput.invokeMethod('TextInput.hide');
      }
    });
  }

  @override
  void dispose() {
    _focusNode.dispose();
    _controller.dispose();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    return RawKeyboardListener(
      focusNode: _focusNode,
      onKey: (RawKeyEvent event) {
        if (event is RawKeyDownEvent) {
          final key = event.logicalKey;
          // 处理普通字符输入
          if (key is LogicalKeyboardKey && key.keyLabel.isNotEmpty) {
            setState(() {
              _controller.text += key.keyLabel;
            });
            widget.onChanged?.call(_controller.text);
          }
          // 处理退格键
          else if (key == LogicalKeyboardKey.backspace && _controller.text.isNotEmpty) {
            setState(() {
              _controller.text = _controller.text.substring(0, _controller.text.length - 1);
            });
            widget.onChanged?.call(_controller.text);
          }
        }
      },
      child: TextField(
        controller: _controller,
        focusNode: _focusNode,
        keyboardType: TextInputType.none,
        enableInteractiveSelection: false,
        decoration: const InputDecoration(
          border: OutlineInputBorder(),
          hintText: '物理键盘输入',
        ),
      ),
    );
  }
}

这个组件通过RawKeyboardListener直接监听物理键盘事件，同时在焦点激活时强制隐藏软键盘，既避免软键盘弹出，又能正常处理物理输入。

方法二：Android原生层面彻底禁用软键盘 #

在android/app/src/main/AndroidManifest.xml中，给目标Activity添加android:windowSoftInputMode="stateAlwaysHidden|adjustPan"属性：

<activity
    android:name=".MainActivity"
    android:exported="true"
    android:launchMode="singleTop"
    android:theme="@style/LaunchTheme"
    android:configChanges="orientation|keyboardHidden|keyboard|screenSize|smallestScreenSize|locale|layoutDirection|fontScale|screenLayout|density|uiMode"
    android:hardwareAccelerated="true"
    android:windowSoftInputMode="stateAlwaysHidden|adjustPan">

还可以通过Flutter调用原生方法加固控制：
创建Android原生方法（MainActivity.kt）：

import android.view.inputmethod.InputMethodManager
import io.flutter.embedding.android.FlutterActivity
import io.flutter.embedding.engine.FlutterEngine
import io.flutter.plugin.common.MethodChannel

class MainActivity : FlutterActivity() {
    private val CHANNEL = "com.example/keyboard"

    override fun configureFlutterEngine(flutterEngine: FlutterEngine) {
        super.configureFlutterEngine(flutterEngine)
        MethodChannel(flutterEngine.dartExecutor.binaryMessenger, CHANNEL).setMethodCallHandler { call, result ->
            if (call.method == "disableSoftKeyboard") {
                val imm = getSystemService(INPUT_METHOD_SERVICE) as InputMethodManager
                imm.hideSoftInputFromWindow(window.decorView.windowToken, 0)
                result.success(true)
            } else {
                result.notImplemented()
            }
        }
    }
}

Flutter端调用：

import 'package:flutter/services.dart';

void disableAndroidSoftKeyboard() async {
  const platform = MethodChannel('com.example/keyboard');
  try {
    await platform.invokeMethod('disableSoftKeyboard');
  } on PlatformException catch (e) {
    print("Failed to disable soft keyboard: ${e.message}");
  }
}

在页面initState中调用该方法，从原生层面确保软键盘不会弹出。

方法三：使用TextInputConnection手动管理输入 #

通过TextInputConnection直接与系统输入服务交互，不请求软键盘：

class PhysicalInputHandler extends StatefulWidget {
  final ValueChanged<String> onInput;

  const PhysicalInputHandler({Key? key, required this.onInput}) : super(key: key);

  @override
  State<PhysicalInputHandler> createState() => _PhysicalInputHandlerState();
}

class _PhysicalInputHandlerState extends State<PhysicalInputHandler> with TextInputClient {
  TextInputConnection? _textInputConnection;
  String _inputText = '';

  @override
  void initState() {
    super.initState();
    // 初始化输入连接，不触发软键盘
    _textInputConnection = TextInput.attach(
      this,
      const TextInputConfiguration(
        inputType: TextInputType.none,
        enableSuggestions: false,
        autocorrect: false,
      ),
    );
    _textInputConnection?.show();
  }

  @override
  void dispose() {
    _textInputConnection?.close();
    super.dispose();
  }

  @override
  void performAction(TextInputAction action) {}

  @override
  void updateEditingValue(TextEditingValue value) {
    setState(() {
      _inputText = value.text;
    });
    widget.onInput(_inputText);
  }

  @override
  Widget build(BuildContext context) {
    return TextField(
      controller: TextEditingController(text: _inputText),
      enabled: false,
      decoration: const InputDecoration(
        border: OutlineInputBorder(),
        hintText: '物理键盘输入',
      ),
    );
  }
}

这种方式让系统处理物理键盘输入逻辑，但不唤起软键盘，适合需要兼容输入法切换等场景。

注意事项 #

• 测试时确保设备物理键盘已连接，模拟器需手动开启物理键盘模拟
• TextInputType.none必须配合输入监听逻辑使用，否则无法接收输入
• 建议结合原生配置和Flutter监听方案，提升兼容性

内容的提问来源于stack exchange，提问作者Anderson Silva Vieira