Flutter添加assets资源图片时出现错误无法正常加载

以下是可直接落地的排查和修复步骤：

1. 修正pubspec.yaml格式问题 #

yaml语法对缩进要求极严格，错误缩进是90%以上配置失效的原因：

• flutter字段顶格书写
• assets字段要比flutter多2个空格缩进，禁止使用tab键缩进
• 每个资源路径要比assets多2个空格缩进
  示例正确配置：

flutter:
  uses-material-design: true
  # 单文件配置写法
  assets:
    - assets/images/login_bg.png
    - assets/images/user_avatar.png
  # 批量配置整个目录写法，末尾必须加斜杠
  # assets:
  #   - assets/images/

2. 确认目录层级匹配 #

assets目录必须放在项目根目录，和lib文件夹、pubspec.yaml文件同级，不要放在lib目录内部。路径大小写要完全匹配，非Windows系统对路径大小写敏感。

3. 执行资源更新操作 #

配置修改完成后按顺序执行以下命令：

• 执行flutter clean清除旧的构建缓存
• 执行flutter pub get重新扫描资源文件
• 若应用正在运行，需要完全停止后冷启动，热重载/热重启不会加载新的assets配置

4. 代码调用路径正确 #

调用图片时路径要和配置的路径完全一致，示例：

Image.asset('assets/images/login_bg.png')

不要漏写路径前缀，也不要随意修改大小写。

内容的提问来源于stack exchange，提问作者Isha Raghav