Flutter 如何为SelectableText构建带自定义操作的文本选择工具栏？

报错原因 #

这个编译报错完全是Flutter版本差异导致的，和你有没有漏抄示例代码没关系。
你参考的老示例是适配Flutter 3.7及更早版本写的，在Flutter 3.10及之后的稳定版中，TextSelectionControls抽象类把选择手柄相关的3个方法（buildHandle、getHandleAnchor、getHandleSize）调整为必须由实现类提供的抽象方法。老示例的编写逻辑是直接实现TextSelectionControls接口，在新版本下自然会触发“未实现抽象方法”的编译错误。

正确的实现路径 #

完全不需要从零手写所有选择手柄的绘制逻辑，复用框架已经封装好的父类就能避开这类版本兼容问题：

• 自定义Controls类不要直接implements TextSelectionControls，改为继承MaterialTextSelectionControls——这个父类已经把报错提到的3个手柄方法全部实现完毕，你不需要重复写
• 只需要重写buildToolbar方法，在方法返回值里替换成你自己设计的操作按钮（删除、分享等），替换系统默认的复制/粘贴菜单
• 将这个自定义的Controls实例，直接传入SelectableText的selectionControls属性，自定义菜单就会在选中文本时弹出

适配注意事项 #

• 如果直接实现抽象接口，不管哪个Flutter版本都需要把所有抽象方法（包括手柄尺寸、锚点定位、绘制逻辑）全部实现，没必要做这种重复造轮子的工作
• 自定义菜单项的点击回调里，可以直接通过SelectableRegionState拿到当前选中的文本范围、关联的消息对象，直接对接删除、分享的业务逻辑，不需要额外监听选中文本的变化
• 升级到Flutter 3.22及以上版本时，要注意buildToolbar的方法签名已经调整，重写时需要和当前SDK的参数列表完全对齐，否则会出现方法签名不匹配的报错

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