Flutter项目图片与字体资源随机加载失败问题求助

针对你遇到的部分资源可正常加载、新增资源报错的情况，按以下步骤逐一排查：

1. 严格校验文件名与路径的一致性 #

Flutter在Android等平台对文件路径/文件名大小写敏感，微小差异都会导致加载失败：

• 确认代码中的资源路径（如assets/images/couple_register_success.jpg）与实际文件的名称、层级完全匹配，包括大小写、扩展名（比如.jpg和.jpeg不能混用）
• 检查文件名是否包含空格、特殊字符，避免因解析问题导致无法识别

2. 确保pubspec.yaml配置的格式正确性 #

YAML文件对缩进要求严格，必须使用空格（禁止用Tab），资源配置需嵌套在flutter:节点下：

flutter:
  uses-material-design: true

  assets:
    - assets/
    - assets/images/
  fonts:
    - family: Test
      fonts:
        - asset: assets/fonts/Gabarito_Black.ttf
          weight: 900
        - asset: assets/fonts/Gabarito_ExtraBold.ttf
          weight: 800
        # 其余字体配置...

若目录扫描存在异常，可尝试单独列出新增资源替代目录配置：

assets:
  - assets/images/couple_start.jpg
  - assets/images/test_image.jpg
  - assets/images/couple_register_success.jpg

3. 执行完整的资源刷新流程 #

仅flutter clean可能无法彻底清除缓存，按顺序执行：

1. 运行 flutter clean
2. 运行 flutter pub get
3. 完全重启项目（不要使用热重载/热重启，直接停止后重新运行）
4. 若问题依旧，手动删除项目根目录下的build文件夹，再重新构建

4. 字体资源的额外检查 #

使用自定义字体时，必须在Text组件的Style中指定对应的fontFamily：

Text(
  'Je account is\naangemaakt',
  style: TextStyle(
    fontSize: 28,
    fontWeight: FontWeight.w700,
    fontFamily: 'Test', // 与pubspec中配置的family名称完全一致
  ),
)

同时验证字体文件是否损坏，可通过系统字体预览工具打开确认。

5. 清除IDE缓存 #

部分IDE可能缓存旧的资源索引，导致新资源无法被识别：

• 直接重启IDE
• 清除IDE缓存（如Android Studio：File -> Invalidate Caches...；VS Code：Ctrl+Shift+P 输入 Reload Window）

内容的提问来源于stack exchange，提问作者Rob Kuijlenburg