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

Flutter运行时无法加载AssetImage图片资源问题求助

Flutter本地图片加载失败解决步骤

  • 首先确认配置文件名拼写是否正确,你描述中提到的pubsec.yaml存在拼写错误,正确配置文件名为pubspec.yaml,拼写错误会导致所有资源配置不生效。
  • 核对pubspec.yaml内assets配置的缩进格式,assets字段必须与uses-material-design字段保持同级,每个资源路径前的缩进、横杠格式必须符合规范,正确示例如下:
flutter:
  uses-material-design: true
  assets:
    - diamond.png

如果你的图片存放在项目的子文件夹(比如assets文件夹)中,配置路径需要和实际存放路径完全对应,比如- assets/diamond.png。

  • 检查图片文件名大小写,Flutter在Android、iOS等移动端设备上严格区分文件名大小写,若实际文件名为Diamond.png,代码中写diamond.png就会出现加载失败的情况。
  • 配置修改完成后必须执行flutter pub get命令,更新资源索引后不要使用热重载/热重启更新应用,需要完全停止当前运行的项目,重新执行运行命令启动应用。
  • 若以上步骤都排查完毕仍有问题,可执行flutter clean清理项目缓存后再重新运行,Canary渠道的Android Studio偶发资源缓存异常的问题,清理缓存即可解决。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.09 22:15:02