Flutter中Unable to load assets问题求助：配置Pubspec.yaml仍加载失败

数据老陈

2026-6-29

Flutter图片加载失败（Assets not found）排查方案

检查Pubspec.yaml配置完整性

确保你的Pubspec.yaml中assets配置处于正确层级，且缩进格式正确（必须用2个空格，不能用Tab）：

flutter:
  assets:
    - images/blank-profile-picture-973460_640.png

如果需要加载整个images文件夹的资源，可简化配置：

flutter:
  assets:
    - images/

清理缓存并重启服务

执行命令清除项目缓存：

flutter clean

重新获取依赖包：

flutter pub get

完全停止当前调试进程，重新运行App（热重载/热重启无法识别新增的资产资源变更）

验证路径与大小写一致性

确认图片文件名、路径和代码中的引用完全一致，Flutter在iOS/macOS环境下区分大小写，比如Blank-Profile.png和blank-profile.png会被识别为不同文件
确保images文件夹位于项目根目录（与lib、pubspec.yaml同级），而非lib文件夹内部

代码引用检查

你的代码中图片引用路径需与Pubspec.yaml配置完全匹配：

Widget build(BuildContext context) {
    return Container(
      decoration: BoxDecoration(
        gradient: LinearGradient(
          colors: gradientcolors,
          begin: startAlignment,
          end: endAlignment,
        ),
      ),
      child: Center(
        child: Image.asset('images/blank-profile-picture-973460_640.png'),
      ),
    );
  }