Flutter上下滚动列表时TextFormField文本选择控件显隐问题解决

• 开发框架版本：Flutter stable 3.0.2
• 问题场景：可滚动列表（如ListView、CustomScrollView）中嵌入TextFormField组件
• 异常表现：点击输入框弹出的带剪切、粘贴、全选功能的文本选择工具栏，在列表上下滚动（尤其向上滚动）时出现错位、无故闪烁、异常显隐的问题。

按优先级从高到低可选以下方案：

1. 升级Flutter版本（官方根治方案） #

这个问题是Flutter 3.0.x稳定分支的框架层已知bug：文本选择工具栏的位置计算逻辑没有同步监听滚动视口的偏移更新，当嵌入的输入框随列表滚动时，工具栏的视口坐标计算错误，就会出现异常显隐。
该问题在Flutter 3.3.0及之后的稳定版本中已经被官方修复，若项目没有强锁3.0.2版本的依赖，直接执行版本升级即可解决，无需额外编写兼容代码，升级命令：

flutter channel stable
flutter upgrade

升级后执行flutter --version确认版本号≥3.3.0即可。

2. 滚动时主动收起工具栏（快速兼容方案） #

如果项目暂时无法升级Flutter版本，可以通过滚动监听主动隐藏异常的工具栏，实现成本极低，不影响原有交互：

1. 为可滚动列表绑定ScrollController
2. 监听滚动事件，一旦检测到滚动触发，直接调用全局方法移除当前显示的文本选择上下文菜单
   示例代码：

// 列表滚动控制器
final ScrollController listScrollController = ScrollController();

@override
void initState() {
  super.initState();
  listScrollController.addListener(() {
    // 滚动时直接移除所有活跃的上下文菜单（即文本选择剪切粘贴栏）
    ContextMenuController.removeAny();
  });
}

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

// 构建列表时传入控制器
@override
Widget build(BuildContext context) {
  return ListView.builder(
    controller: listScrollController,
    itemCount: 20,
    itemBuilder: (context, index) {
      return Padding(
        padding: const EdgeInsets.all(16),
        child: TextFormField(
          // 输入框自身配置无需改动
        ),
      );
    },
  );
}

这个方案不需要修改每个输入框的配置，全局监听一次即可覆盖列表内所有输入框的场景。

3. 保留列表项状态（临时验证方案，不推荐长列表使用） #

如果只是临时调试验证问题原因，可以给列表内的输入框增加保活逻辑，避免输入框滑出视口时被框架回收导致工具栏关联状态丢失：

• 将列表的addAutomaticKeepAlives属性设为true（默认即为true，若之前手动关闭需要改回）
• 给列表项的输入框根组件混入AutomaticKeepAliveClientMixin，重写wantKeepAlive返回true
  注意：这个方案会让滑出屏幕的列表项不会被回收，长列表场景下会大幅增加内存占用，仅可临时使用，不可作为线上最终方案。

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