Flutter使用Image.asset加载assets文件夹图片无法显示求助

Flutter assets图片无法加载问题排查方案 #

核心问题 #

你当前最明显的错误是代码引用路径和pubspec配置路径不匹配：代码中调用Image.asset时传入的是assets/images/genvcarelogo.png，但pubspec中配置的资源路径为images/genvcarelogo.png，二者必须完全一致才能正常加载。 #

逐项排查修复步骤 #

• 对齐资源路径
  如果你的图片实际存放路径为项目根目录/assets/images/genvcarelogo.png，将pubspec.yaml中的assets配置修改为：

  assets:
    - assets/images/genvcarelogo.png
  

  也可以直接配置整个图片文件夹，后续新增同目录下的图片无需重复配置：

  assets:
    - assets/images/
  

  配置修改完成后必须执行flutter pub get，并重启运行中的应用（热重载不会更新资源配置，热重启也可能不生效，建议完全停止应用后重新启动调试）。
• 校验pubspec缩进规则
  注意assets是flutter节点的子级，缩进必须正确，完整的正确结构示例：

  flutter:
    uses-material-design: true
    # assets节点要比flutter节点多1个tab或2个空格的缩进
    assets:
      - assets/images/genvcarelogo.png
  

  如果assets和flutter平级，配置会完全失效。
• 校验路径大小写
  检查实际文件夹、文件名的大小写和配置、代码中书写的内容是否完全一致，Flutter在iOS、Linux等系统下对路径大小写敏感，比如Genvcarelogo.png和genvcarelogo.png会被识别为两个不同的文件。
• 确认资源存放位置
  检查assets文件夹是否放在项目根目录下，不要嵌套到lib文件夹中。

内容的提问来源于stack exchange，提问作者jyothi chandra