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

Flutter部分图片资产加载失败:Asset not found问题求助

解决Flutter资源加载「Asset not found」问题

针对你遇到的部分图片资源加载失败的情况,可按以下步骤排查解决:

  • 清理缓存并重建项目
    执行以下命令清除Flutter缓存,重新获取依赖,然后重启IDE和设备:

    flutter clean
    flutter pub get
    

    缓存残留是这类问题的常见诱因,尤其是新添加资源后未清理缓存时。

  • 核对文件名大小写
    Flutter在Android、Linux等平台对文件名大小写敏感,即使你在pubspec.yaml里写的是小写,实际文件如果是大写开头(比如Notifications.png)就会加载失败。仔细比对配置里的文件名和实际文件的大小写是否完全一致。

  • 改用文件夹通配符配置资源
    避免单个文件配置可能出现的拼写错误,直接配置整个图片目录:

    assets:
      - assets/images/
    

    这样该目录下所有文件都会被自动识别,无需逐个添加。

  • 检查代码中的资源路径拼写
    确认调用图片时的路径和pubspec.yaml里的配置完全匹配,比如报错中的assets/images/test.png,要检查代码里是否写错了路径(比如少写了images的s,或者多打了斜杠),同时注意引号是否正确包裹路径。

  • 确认文件实际位置
    再次核对图片文件是否确实放在assets/images/根目录下,没有被误放到子文件夹中,比如assets/images/icons/这类子目录,而配置里没包含子路径。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.07.12 02:42:06