Flutter无法加载资源图片怎么办？代码无报错pubspec.yaml曾正常工作

AI 小北

2026-8-23

Flutter加载本地图片提示“Unable to load asset”的解决方法

问题场景

代码无语法报错，pubspec.yaml此前可正常工作，但使用Image.asset('anyaparent.jpeg')加载图片时提示“Unable to load asset”，相关代码：

@override
Widget build(BuildContext context) {
  return MaterialApp(
    home: Scaffold(
      body: SafeArea(
        child: Column(
          children: [
            Card(
              child: Image.asset('anyaparent.jpeg'),
            ),
          ],
        ),
      ),
    );
}

报错提示：Unable to load asset

排查与解决步骤

确认图片路径和文件名
检查anyaparent.jpeg是否在配置的assets目录下，路径要和pubspec里的配置完全匹配；Flutter对文件名大小写敏感，注意不要写错大小写。
检查pubspec.yaml配置格式
确保assets配置的缩进和语法正确，示例如下（根据实际路径调整）：
```
flutter:
  assets:
    - assets/anyaparent.jpeg
```
注意：flutter:下方的assets:必须缩进2个空格，每项资源路径也要再缩进2个空格，不能有语法错误。如果需要加载整个目录的资源，要写成- assets/（末尾加斜杠）。
重启项目并清理缓存
修改pubspec.yaml后热重载无效，必须完全关闭项目后重新启动；也可以执行以下命令清理缓存后再运行：
```
flutter clean
flutter pub get
```
验证文件存在性
手动到项目目录中确认图片文件未被误删，实际路径和代码中填写的一致。