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

Flutter图片渲染异常求助:无法加载本地资源图片

Flutter 本地图片加载失败问题排查方案

针对你遇到的「Unable to load asset: "Images/diamond.png"」异常,给你几个实用的排查方向:

  • 严格匹配路径大小写
    Flutter在类Unix系统(macOS/Linux)下对文件路径大小写敏感,确认你的实际文件夹名称是Images而非images,代码中的路径必须和实际文件系统中的名称完全一致。

  • 确认文件位置正确
    确保diamond.png直接放在项目根目录的Images文件夹下,项目结构应该是这样:

    你的项目根目录/
      lib/
      Images/
        diamond.png
      pubspec.yaml
    

    不要把图片放在lib目录或者其他子文件夹里。

  • 重新刷新资源配置
    修改pubspec.yaml后,执行以下命令清理并重新获取资源:

    flutter clean
    flutter pub get
    

    之后重启应用(不要仅依赖热重载,热重载可能不会更新资源配置)。

  • 检查YAML文件缩进
    YAML对缩进要求极高,确认assets:下的- Images/是用两个空格缩进,和uses-material-design:保持同一层级,示例:

    flutter:
      uses-material-design: true
      assets:
        - Images/
    

    缩进错误会导致Flutter无法识别资源配置。

  • 尝试指定具体文件路径
    可以先在pubspec.yaml里直接指定图片的完整路径测试:

    flutter:
      uses-material-design: true
      assets:
        - Images/diamond.png
    

    如果这样能成功加载,再排查文件夹配置的问题。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.06.30 14:37:13