Flutter报错：ListTile组件不存在命名参数horizontalTitleGap如何解决

问题原因 #

你当前使用的Flutter SDK版本过低，ListTile 组件的 horizontalTitleGap 参数是 Flutter 1.22.0 稳定版才新增的属性，你当前的Dart SDK约束对应Flutter版本低于1.22.0，因此无法识别该参数导致报错。

解决方案 #

方案1：升级Flutter SDK（推荐） #

如果项目可以适配高版本SDK，直接升级Flutter到1.22.0及以上版本即可兼容该参数。
修改项目根目录下 pubspec.yaml 中的SDK约束：

environment:
  sdk: '>=2.12.0 <3.0.0' # 至少升级到2.12.0，对应Flutter 2.x及以上版本兼容性更好

修改后执行 flutter pub get 重新拉取依赖即可。

方案2：低版本兼容替代（无需升级SDK） #

如果项目暂时不能升级SDK，可以直接删除所有 horizontalTitleGap 参数，用以下方式实现同等的间距效果：
在 leading 的图标外层套 Padding 调整间距，或者直接调整 ListTile 的 contentPadding 参数控制整体内边距即可。

举个替换示例，把原有代码：

ListTile(
  onTap: () {},
  leading: Icon(Icons.history),
  title: Text('My Orders'),
  horizontalTitleGap: 2,
),

替换为：

ListTile(
  onTap: () {},
  leading: Padding(
    padding: EdgeInsets.only(right: 2), // 这里的数值对应原来的horizontalTitleGap值
    child: Icon(Icons.history),
  ),
  title: Text('My Orders'),
),

所有用到horizontalTitleGap的位置都按照这个逻辑修改即可解决报错，同时实现相同的视觉效果。

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