Flutter图片组件加载报错求助:已配置pubspec.yaml仍失败
Flutter 本地图片加载报错排查方案
问题排查与修复步骤
1. 修正pubspec.yaml文件名拼写
你代码里写的是pubsec.yaml,正确文件名是**pubspec.yaml**,拼写错误会导致Flutter无法读取资源配置,这是最常见的低级错误。
2. 检查YAML格式缩进
YAML对缩进要求严格,assets配置必须嵌套在flutter节点下,且子条目用2个空格缩进(禁止用Tab),正确格式如下:
flutter: assets: - assets/images/
3. 验证文件路径与大小写
Flutter在iOS/macOS等系统对文件路径大小写敏感,确认:
- 图片实际路径是
assets/images/login.jpg,文件名没有大小写偏差(比如不是Login.jpg) - 该路径下确实存在目标图片文件
4. 重启服务并清理缓存
修改pubspec.yaml后热重载可能不生效,执行以下操作:
- 停止当前Flutter运行进程
- 执行缓存清理命令:
flutter clean - 重新启动项目:
flutter run
5. 尝试指定具体文件名
如果通配路径不生效,可直接列出具体图片文件路径:
flutter: assets: - assets/images/login.jpg
代码中保持AssetImage("assets/images/login.jpg")不变,再重新运行项目。
内容的提问来源于stack exchange,提问作者Priyanka Patel
相关产品推荐
相关产品推荐

