You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Flutter添加字体时遇错误,求助排查问题原因

Flutter添加字体错误截图

Flutter 添加字体错误排查步骤
  • 检查pubspec.yaml配置
    确认yaml缩进严格使用2个空格,字体配置块必须嵌套在flutter节点下,示例:

    flutter:
      fonts:
        - family: YourFontFamily
          fonts:
            - asset: fonts/YourFont-Regular.ttf
            - asset: fonts/YourFont-Bold.ttf
              weight: 700
    

    同时保证family名称和代码中TextStyle(fontFamily: 'xxx')的名称完全一致,asset路径要和字体文件实际位置匹配。

  • 验证字体文件
    确认字体文件未损坏,能在本地正常打开;文件名避免特殊字符、空格,推荐用短横线或驼峰命名。

  • 清理缓存并重载配置
    执行flutter clean清理项目缓存,再运行flutter pub get重新加载配置,之后重启IDE和模拟器/真机。

  • 检查代码使用
    确保代码中指定的fontFamily和pubspec里的family大小写完全一致;如果是全局配置字体,确认MaterialApp的theme配置正确:

    MaterialApp(
      theme: ThemeData(
        fontFamily: 'YourFontFamily',
      ),
    )
    
  • 确认项目结构
    字体文件夹(如fonts)要放在项目根目录,和pubspec.yaml同级,不能放在lib目录下。


内容的提问来源于stack exchange,提问作者Diksonim

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.06 13:25:18