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

Flutter中使用Image.asset加载特定图片失败问题求助

Flutter单张图片加载失败排查方案

以下是针对仅perigo.png无法通过Image.asset加载的排查步骤:

  • 检查图片文件完整性
    直接用系统图片查看器打开perigo.png,确认文件没有损坏、能正常显示。如果损坏,重新获取或替换该图片。

  • 核对路径与文件名

    1. 确认图片实际存放在项目根目录的assets文件夹下,文件名完全匹配perigo.png——注意区分大小写(iOS、macOS环境对文件名大小写敏感,不要出现Perigo.png这类大小写错误)。
    2. 你的pubspec.yaml配置- assets/会包含该目录下所有文件,路径配置本身没问题,但要确保文件层级正确,没有放错子目录。
  • 清理项目缓存并重启
    依次执行以下命令,清除可能的缓存问题:

    flutter clean
    flutter pub get
    

    之后重新启动项目,尝试加载图片。

  • 转换图片格式为标准PNG
    部分非标准编码的PNG可能无法被Flutter解析,用图片编辑工具(如Photoshop)或在线转换工具,将图片重新导出为标准PNG格式后再替换原文件。

  • 验证pubspec.yaml格式正确性
    YAML文件对缩进要求严格,确保assets配置的格式如下(注意缩进为空格,不要用制表符):

    assets:
      - assets/
    

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.08.02 11:16:55