Flutter Desktop ListView获焦项如何添加自定义快捷键避免焦点错乱

焦点错乱的核心原因是ListView.builder的懒加载机制和单列表项绑定独立RawKeyboardListener的实现逻辑冲突：

• ListView.builder只会构建可视范围内的列表项，滚出可视区域的项会被销毁，对应手动创建的FocusNode实例也会被回收
• 回滚时重新构建的列表项会生成全新的FocusNode实例，这些新节点没有被正确纳入ListView内置的焦点遍历链，最终导致焦点跳转顺序错位、乱跳。

不要给每个列表项单独套RawKeyboardListener，用顶层单监听+焦点状态记录的方案实现，完全不破坏ListView原生的焦点遍历逻辑，从根源避免焦点错乱：

1. 在页面顶层放置唯一的RawKeyboardListener，统一接管全页面的按键事件
2. 借助InkWell自带的onFocusChange回调，实时记录当前处于聚焦状态的列表项索引
3. 在顶层键盘监听的回调中，匹配目标按键，结合当前聚焦的索引执行对应业务逻辑

修正后的可运行代码如下：

import 'package:flutter/material.dart';
import 'package:flutter/services.dart';

void main() {
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({Key? key}) : super(key: key);

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        primarySwatch: Colors.orange,
      ),
      home: const MyHomePage(),
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({Key? key}) : super(key: key);

  @override
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  // 记录当前聚焦的列表项索引
  int _focusedIndex = -1;

  @override
  Widget build(BuildContext context) {
    // 顶层仅设置一次键盘监听
    return RawKeyboardListener(
      focusNode: FocusNode(),
      autofocus: true,
      onKey: (event) {
        // 仅处理按键按下事件，避免按键抬起时重复触发
        if (event is! RawKeyDownEvent || _focusedIndex < 0) return;
        
        // 用LogicalKeyboardKey内置常量匹配按键，避免不同键盘布局下字符串匹配失效
        if (event.logicalKey == LogicalKeyboardKey.numpadAdd) {
          print('触发小键盘加号逻辑，当前选中项：$_focusedIndex');
          // 此处写入小键盘加号对应的业务逻辑
        }
        if (event.logicalKey == LogicalKeyboardKey.keyA) {
          print('触发A键逻辑，当前选中项：$_focusedIndex');
          // 此处写入A键对应的业务逻辑
        }
      },
      child: Scaffold(
        appBar: AppBar(
          title: const TextField(),
        ),
        body: ListView.builder(
          itemCount: 100,
          itemBuilder: (context, index) {
            return InkWell(
              focusColor: Colors.blue,
              // 焦点变化时同步更新当前聚焦索引
              onFocusChange: (isFocused) {
                if (isFocused) {
                  setState(() {
                    _focusedIndex = index;
                  });
                }
              },
              onTap: () => print('点击项 $index'),
              child: Padding(
                padding: const EdgeInsets.all(8.0),
                child: SizedBox(
                  height: 50,
                  child: Text('列表项 $index'),
                ),
              ),
            );
          },
        ),
      ),
    );
  }
}

• 完全保留ListView原生的焦点遍历逻辑，没有给单个列表项手动创建FocusNode，不会因为列表项懒加载销毁重建导致焦点链断裂，任意滚动都不会出现焦点错位
• 按键匹配使用Flutter内置的LogicalKeyboardKey常量，不依赖keyLabel字符串判断，不会受系统语言、键盘布局差异影响
• 不需要为每个列表项单独嵌套监听组件，代码更简洁，性能损耗更低

如果页面存在输入框、按钮等其他可聚焦组件，只需要在顶层onKey回调中额外判断当前焦点所属的组件范围即可，避免非列表区域按键误触发列表逻辑。

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