Flutter升级后自定义阿拉伯字体连笔渲染异常求助

升级Flutter后自定义阿拉伯字体出现字母分离、无法连笔的情况，大概率是新版本字体渲染逻辑调整，默认关闭了旧字体依赖的部分排版特性。以下是针对性解决方法：

• 强制启用阿拉伯文必需的排版特性
  阿拉伯文连笔依赖calt（上下文替代）、clig（上下文连字）、liga（标准连字）等OpenType特性，单独开启liga可能不够。修改TextStyle：

  Text(
    'مرحبا بالعالم',
    style: TextStyle(
      fontFamily: 'muhammadi',
      fontSize: 20,
      fontFeatures: [
        FontFeature.enable('liga'),
        FontFeature.enable('calt'),
        FontFeature.enable('clig'),
        FontFeature.enable('kern'), // 可选，优化字符间距
      ],
    ),
    textDirection: TextDirection.rtl,
  )
  

• 检查字体导入与缓存

  1. 确认pubspec.yaml里字体路径无拼写错误：

     fonts:
       - family: muhammadi
         fonts:
           - asset: assets/fonts/muhammadi.ttf # 替换为你的实际路径
     

  2. 执行flutter clean → flutter pub get，重启应用刷新字体缓存。

• 临时调整渲染逻辑
  如果上述方法无效，可能是新版本Skia引擎对该字体兼容性下降，在main.dart中添加代码强制调整：

  import 'dart:ui' as ui;
  
  void main() {
    ui.FontFeature.disable('ss01'); // 尝试禁用可能影响的特性
    runApp(MyApp());
  }
  

• 修复字体文件
  部分旧字体的OpenType连字表可能不完整，用FontForge这类工具将字体转换为标准TTF格式，修复缺失的排版表后重新导入。

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