Flutter中pubspec.yaml配置图片路径后仍报图片资源未设置错误怎么办

校验pubspec.yaml配置格式 #

yaml格式对缩进要求极为严格，层级错误是最高发的诱因：

• 确保assets:字段为flutter:节点的直接子级，二者保持2个半角空格的缩进差
• 所有资产路径列表要缩进在assets:字段下方，同样保持2个半角空格间隔
• 全程禁止使用Tab字符缩进，所有缩进替换为半角空格

正确配置参考：

flutter:
  assets:
    - assets/images/
    - assets/icons/app_icon.png

常见典型错误：将assets:写在flutter:节点的同级层级，导致整套配置无法被Flutter识别加载。

校验路径匹配精度 #

• pubspec.yaml中登记的资产路径，必须和项目内实际文件的相对路径完全一致，包含大小写校验——Windows系统对路径大小写不敏感，但iOS、Android端打包时会严格匹配大小写，不一致就会触发资产未找到的报错
• 如果配置目录级路径（例如直接写assets/images/），需确保该目录下至少存在1个实际图片文件，空目录不会被纳入资产打包范围

清理无效构建缓存 #

• 每次修改完pubspec.yaml的资产配置后，必须先执行flutter pub get，等待命令执行完成后再启动应用，不能仅依靠热重载加载新配置
• 上述配置都确认无误仍报错时，执行flutter clean清空本地构建缓存，重新执行flutter pub get后再启动项目——旧构建缓存会残留之前的资产索引表，和新配置无法对齐

校验代码内调用一致性 #

• 使用Image.asset()调用图片时，填写的路径必须和pubspec.yaml中登记的路径完全匹配，不能出现层级漏写、前缀错加的问题
• 排查动态拼接路径的逻辑，确认拼接过程中没有额外增减路径层级

内容的提问来源于stack exchange，提问作者Harshit rai