Flutter：使用TextField读取条码时彻底隐藏软键盘

一、解决页面打开时软键盘短暂弹出的问题 #

核心思路是避免TextField自动获取焦点，或从根源上不依赖TextField的焦点机制：

• 禁用TextField的自动获焦与编辑能力
  使用readOnly: true、showCursor: false，并通过FocusNode阻止其请求焦点：

  final FocusNode _scanFocusNode = FocusNode();
  
  @override
  void initState() {
    super.initState();
    // 禁止该焦点节点请求焦点，彻底避免唤起软键盘
    _scanFocusNode.canRequestFocus = false;
  }
  
  @override
  Widget build(BuildContext context) {
    return TextField(
      focusNode: _scanFocusNode,
      readOnly: true,
      showCursor: false,
      controller: _barcodeController,
      decoration: const InputDecoration(
        hintText: "等待扫码",
        border: OutlineInputBorder(),
      ),
    );
  }
  

• 强制隐藏软键盘（兜底方案）
  在页面初始化时调用平台通道强制隐藏软键盘，需导入package:flutter/services.dart：

  @override
  void initState() {
    super.initState();
    WidgetsBinding.instance.addPostFrameCallback((_) {
      SystemChannels.textInput.invokeMethod('TextInput.hide');
    });
  }
  

• 替代方案：不用TextField，改用自定义展示容器
  直接用Text组件配合手势触发扫码，彻底规避软键盘问题：

  String _scannedCode = "";
  
  void _triggerScan() {
    // 调用内置扫码器逻辑，扫码完成后更新_scannedCode
  }
  
  @override
  Widget build(BuildContext context) {
    return GestureDetector(
      onTap: _triggerScan,
      child: Container(
        padding: const EdgeInsets.symmetric(horizontal: 16, vertical: 12),
        decoration: BoxDecoration(
          border: Border.all(color: Colors.grey.shade300),
          borderRadius: BorderRadius.circular(8),
        ),
        child: Text(_scannedCode.isEmpty ? "点击扫码" : _scannedCode),
      ),
    );
  }
  

二、解决“SPAN_EXCLUSIVE_EXCLUSIVE spans cannot have a zero length”错误 #

该错误源于文本跨度（TextSpan）的无效操作，通常是处理空条码或错误的光标选中范围导致，解决方式如下：

• 过滤空条码，避免空文本赋值
  在扫码回调中先判断条码是否为空，再更新控制器：

  void _onBarcodeReceived(String? barcode) {
    if (barcode == null || barcode.isEmpty) return;
    _barcodeController.text = barcode;
    // 正确设置光标位置，避免零长度选中
    _barcodeController.selection = TextSelection.fromPosition(
      TextPosition(offset: barcode.length),
    );
  }
  

• 避免设置零长度的文本选中范围
  不要直接设置TextSelection(baseOffset: 0, extentOffset: 0)这类无效选中，仅在文本非空时调整光标位置。

• 检查扫码库版本
  若使用第三方扫码库，旧版本可能存在文本处理bug，升级到最新稳定版可解决此类底层问题。

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