Flutter中Asset图片无法显示及pubspec.yaml报错问题

架构老林

2026-6-22

解决pubspec.yaml资源路径报错的方法

严格匹配路径大小写：Flutter在iOS、macOS这类系统下对文件路径大小写敏感，确认pubspec.yaml里写的assets/warning_lights/tpms.jpg和实际文件的文件名、文件夹名大小写完全一致，哪怕一个字母大小写不对都会报错。
核对文件夹层级：确认项目根目录下的assets文件夹里，确实存在warning_lights子文件夹，且tpms.jpg就放在这个子文件夹里，别把文件放错层级。
检查yaml配置格式：yaml对缩进要求极严，必须用空格（不能用tab），正确的assets配置格式应该是这样：
```
flutter:
  assets:
    - assets/warning_lights/tpms.jpg
```
注意flutter:下面的assets:要缩进2个空格，每个资源路径前面是2个空格+短横线+1个空格。
清缓存重启：执行flutter clean命令清除项目缓存，然后关掉IDE重新打开，再运行项目，缓存残留也可能导致资源识别失败。
确认真实文件扩展名：有些系统会隐藏文件扩展名，别被表面的.jpg误导，在文件管理器里开启“显示文件扩展名”，确认文件实际后缀就是.jpg，不是tpms.jpg.png这类伪装的格式。