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

Flutter应用突发unable to locate asset for font错误,求排查解决

Flutter "unable to locate asset entry for a font" 问题排查方案
  • 核对字体文件路径与配置一致性
    确认pubspec.yaml中配置的字体路径和实际文件的路径、文件名完全匹配,注意大小写(类Unix系统/iOS环境的文件系统区分大小写),比如配置fonts/OpenSans-Regular.ttf,实际文件不能是fonts/opensans-regular.ttf。
  • 重置依赖锁文件
    删除当前的pubspec.lock文件,执行命令 flutter pub get 重新生成锁文件,排除依赖版本变更引发的资源加载异常。
  • 清理项目缓存
    执行 flutter clean 清除项目构建缓存,之后重新运行项目,避免缓存中损坏的资源索引导致问题。
  • 验证字体文件完整性
    替换当前字体文件为备份的正常版本,或者临时改用一个测试字体(比如系统默认字体)配置到pubspec.yaml中,测试是否能正常加载,以此排查是否是字体文件本身损坏。
  • 二次校验pubspec.yaml配置格式
    除了缩进,确认字体配置的层级结构正确,示例如下:
    flutter:
      uses-material-design: true
      fonts:
        - family: CustomFont
          fonts:
            - asset: fonts/CustomFont-Regular.ttf
    
    确保使用2个空格作为缩进单位,不要混用Tab和空格。
  • 清理IDE缓存
    若使用Android Studio/IntelliJ,执行File -> Invalidate Caches...并重启IDE,排除IDE缓存导致的配置未同步问题。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.08.05 10:21:02