我最近刚踩完这个一模一样的大坑！自定义l10n.yaml里的output-dir后，不管本地调试还是GitHub Actions构建，全报找不到app_localizations.dart的错误，连带着一堆AppLocalizations未定义的问题，折腾了好几天终于彻底解决了，把我的排查思路和实操步骤分享给你：

核心问题：你可能漏加了一个关键配置项！ #

90%的概率是l10n.yaml里没开 synthetic-package: false——Flutter默认会把生成的本地化文件放到.dart_tool的“虚拟包”里，就算你指定了output-dir，没关这个参数的话，生成的文件根本不会落到你指定的lib/generated_l10n目录里！

第一步：修正本地化配置文件 #

先把l10n.yaml补全关键参数，确保每一项都和下面一致：

arb-dir: lib/l10n
template-arb-file: app_de.arb
output-localization-file: app_localizations.dart
output-class: AppLocalizations
output-dir: lib/generated_l10n  # 你的目标路径，确保没有多余斜杠
synthetic-package: false  # 必须加！关闭虚拟包模式，让文件真正生成到指定目录

同时确认pubspec.yaml里的生成开关是开启的，且没有残留flutter_gen的配置：

name: uccelli_info_app
# ...其他基础配置
flutter:
  generate: true  # 这是Flutter内置本地化生成的核心开关，必须设为true
  uses-material-design: true
  # ...你的assets等其他配置

第二步：本地彻底清缓存+强制重新生成 #

普通的flutter clean有时候不够彻底，要执行一套“终极清理套餐”：

1. 先关闭你的IDE（VS Code/Android Studio），避免缓存锁文件
2. 手动删除项目根目录下的这几个内容：
   • .dart_tool文件夹
   • pubspec.lock文件
   • build文件夹
3. 打开终端，执行：

   flutter pub cache clean --force
   flutter pub get
   flutter gen-l10n --verbose  # 手动触发生成，看输出确认文件路径是否正确（应该显示输出到lib/generated_l10n）
   

4. 重启IDE，然后清除分析器缓存：
   • VS Code：按Ctrl+Shift+P打开命令面板，执行Dart: Restart Analysis Server
   • Android Studio：点击File -> Invalidate Caches...，勾选Clear file system cache and local history，然后点Invalidate and Restart

第三步：修复GitHub Actions的CI构建问题 #

CI环境是干净的，但容易因为版本不一致、缓存残留或者生成时机问题报错，调整你的Workflow步骤：

1. 锁定Flutter版本和本地一致，避免stable通道自动更新导致行为变化：

   - name: Set up Flutter (stable channel)
     uses: subosito/flutter-action@v1
     with:
       channel: stable
       flutter-version: '3.29.3'  # 和你本地用的版本完全一致！
   

2. 在flutter pub get之后，手动触发本地化生成，不要依赖提交的文件（CI环境可能会因为路径/权限问题读取不到提交的生成文件）：

   - name: Get Flutter dependencies (verbose)
     working-directory: uccelli_info_app
     run: flutter pub get --verbose
   - name: Generate localization files explicitly
     working-directory: uccelli_info_app
     run: flutter gen-l10n --verbose  # 强制在CI环境生成到指定目录
   - name: Build release APK
     working-directory: uccelli_info_app
     run: flutter build apk --release
   

3. 不要缓存.dart_tool文件夹——这个目录里的内容是动态生成的，缓存只会导致旧文件残留干扰构建。

第四步：清除所有flutter_gen的残留 #

你提到错误日志里偶尔会出现flutter_gen的路径，说明之前的依赖残留还在搞鬼：

1. 检查pubspec.yaml的dev_dependencies，确保完全删除了flutter_gen相关依赖
2. 检查项目根目录有没有flutter_gen.yaml之类的残留配置文件，有的话直接删掉
3. 确认gitignore里没有误把lib/generated_l10n目录忽略（你已经说没忽略，但再检查一遍更保险）

验证效果 #

做完上面的步骤后：

• 本地运行flutter run，应该不会再报import错误，本地化功能正常
• 推代码到GitHub，看Actions构建日志，应该能顺利生成APK，没有找不到文件的报错

内容来源于stack exchange