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配置格式
除了缩进,确认字体配置的层级结构正确,示例如下:
确保使用2个空格作为缩进单位,不要混用Tab和空格。flutter: uses-material-design: true fonts: - family: CustomFont fonts: - asset: fonts/CustomFont-Regular.ttf - 清理IDE缓存
若使用Android Studio/IntelliJ,执行File -> Invalidate Caches...并重启IDE,排除IDE缓存导致的配置未同步问题。
内容的提问来源于stack exchange,提问作者Filwah Ah
相关产品推荐
相关产品推荐

