项目运行提示资源文件assets/x.jpg不存在 新增图片无法加载如何解决

• 检查文件名匹配情况：注意文件名大小写敏感，Windows/macOS开发环境大小写不敏感，但打包后或者Linux环境会严格校验，确认实际文件名和配置、代码中引用的文件名完全一致，同时检查文件名是否包含空格、中文、全角符号等特殊字符，这类字符也可能导致资源识别失败。
• 校验pubspec.yaml缩进规则：Flutter的pubspec配置对缩进要求严格，assets配置项需要比上层flutter字段缩进2个空格，每个资源路径需要比assets字段再缩进2个空格，参考正确写法：

flutter:
  assets:
    - assets/x.jpg

同时检查assets相关配置是否被注释符号#意外注释。

• 核对资源实际路径：确认项目根目录下存在assets文件夹，且x.jpg直接存放在该文件夹下，无额外嵌套层级，同时资源路径前不要添加斜杠，/assets/x.jpg的写法是错误的。
• 清理缓存重新拉取资源：修改pubspec配置后必须执行flutter pub get，如果仍无法识别，执行flutter clean清空项目构建缓存，重启IDE后重新运行项目即可。
• 检查代码调用路径：确认代码中引用资源的路径和配置完全一致，如果你使用了自定义封装的资源加载工具，检查工具是否会自动拼接assets/前缀，避免出现重复前缀导致路径变成assets/assets/x.jpg的问题。

内容的提问来源于stack exchange，提问作者Shadat Hossen