Flutter中flutter_gen导入URI时而失效问题求助

问题背景 #

已完成以下前置工作：

• 成功生成.dart_tool/flutter_gen/gen_l10n/app_localizations.dart文件
• arb_merger包拆分合并.arb文件的流程正常
• 代码中通过import 'package:flutter_gen/gen_l10n/app_localizations.dart';导入国际化类

但同一代码环境下偶发出现两类错误：

• Target of URI doesn't exist: 'package:flutter_gen/gen_l10n/app_localizations.dart'.
• Undefined 'AppLocalizations'

已尝试重启VSCode、执行flutter clean、flutter gen-l10n等操作，问题仍未解决。

针对性解决方案 #

1. 强制刷新Dart分析器缓存 #

VSCode的Dart分析器偶尔会缓存旧状态，即使文件已生成也会误报：

• 打开命令面板（Ctrl+Shift+P / Cmd+Shift+P）
• 执行 Dart: Restart Analysis Server
• 等待分析器重启完成后检查错误是否消失

2. 固定arb合并与代码生成的执行顺序 #

由于使用arb_merger处理多语言文件，需确保合并完成后再生成国际化代码：

• 手动执行合并命令：dart run arb_merger
• 再执行flutter gen-l10n
• 最后重启项目，避免文件生成顺序导致的分析延迟

3. 验证pubspec.yaml配置的有效性 #

确保flutter.generate: true配置正确且未被覆盖：

• 检查flutter节点下的generate: true无缩进错误
• 执行flutter pub get，让Flutter重新识别配置并触发文件生成

4. 排查IDE工作区路径缓存 #

多工作区环境下VSCode可能混淆文件路径：

• 关闭当前工作区，仅打开当前Flutter项目所在文件夹
• 检查.vscode/settings.json的files.exclude配置，确保.dart_tool未被排除（否则分析器无法识别生成的文件）

5. 添加自动执行钩子避免手动遗漏 #

在pubspec.yaml中添加脚本钩子，确保每次pub get后自动完成合并与生成：

scripts:
  postpubget: dart run arb_merger && flutter gen-l10n

后续执行flutter pub get时会自动先合并arb文件，再生成国际化代码。

6. 确认l10n.yaml配置匹配导入路径 #

检查l10n.yaml的输出配置与代码导入是否一致：

• 确保output-localization-file: app_localizations.dart和output-class: AppLocalizations与代码中的使用完全匹配
• 不要自定义output-dir配置（默认生成路径.dart_tool/flutter_gen/gen_l10n/与导入路径package:flutter_gen/gen_l10n/对应）

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