Flutter国际化开发中app_localizations.dart导入失败及生成路径异常问题

你好，我来帮你解决这个困扰你的Flutter国际化导入问题～ 咱们先把问题的核心理清楚，再给出针对性的解决方案：

问题根源分析 #

你遇到的本质问题是l10n.yaml配置与预期生成路径不匹配，导致导入语句和文件实际位置错位：

• 当你在l10n.yaml中指定了arb-dir: lib/l10n但未配置output-dir时，flutter gen-l10n会默认将生成的app_localizations.dart及多语言文件放在arb-dir（也就是lib/l10n/）目录下，而非官方文档默认的.dart_tool/flutter_gen/gen_l10n/路径。
• 此时你沿用官方的导入语句import 'package:flutter_gen/gen_l10n/app_localizations.dart';自然找不到文件，因为这个路径指向的是.dart_tool下的生成文件，而你的文件实际在lib/l10n/里。

两种可行解决方案（按需选择） #

方案一：调整配置，让文件生成到默认的.dart_tool路径（推荐）

这种方式完全贴合官方规范，不需要修改导入语句。你只需要调整l10n.yaml的配置即可：

修改后的l10n.yaml内容（指定输出路径到默认的.dart_tool目录）：

arb-dir: lib/l10n
template-arb-file: app_en.arb
output-localization-file: app_localizations.dart
output-dir: .dart_tool/flutter_gen/gen_l10n

或者你可以简化为最基础的配置，让工具自动处理路径：

template-arb-file: app_en.arb

（注：默认arb-dir就是lib/l10n，不指定output-dir和output-localization-file时，文件会自动生成到.dart_tool/flutter_gen/gen_l10n/）

完成配置修改后，执行以下步骤：

1. 手动删除lib/l10n/下所有自动生成的.dart文件（只保留.arb语言文件）
2. 运行flutter clean清理项目缓存
3. 在项目根目录执行flutter gen-l10n重新生成文件
4. 执行flutter pub get，并重启VSCode的Dart分析服务（或直接重启VSCode）

此时生成的文件会出现在.dart_tool/flutter_gen/gen_l10n/目录下，你的原始导入语句就能正常识别了。

方案二：修改导入路径，适配当前生成位置

如果你希望继续将生成文件保留在lib/l10n/目录下，只需要把导入语句改成你项目的package路径即可：

1. 打开pubspec.yaml，找到最顶部的name字段，这就是你的项目package名称（比如my_flutter_app）
2. 将导入语句修改为：

import 'package:my_flutter_app/l10n/app_localizations.dart';

（记得把my_flutter_app替换成你实际的项目package名称）

修改完成后，执行flutter pub get并重启Dart分析服务，导入错误就会消失。

额外排查建议 #

1. 确保pubspec.yaml中的flutter: generate: true配置正确，这是自动触发代码生成的关键
2. 如果你使用VSCode，建议更新Dart和Flutter插件到最新版本，避免插件缓存导致的路径识别问题
3. 执行flutter gen-l10n时，一定要在项目根目录下运行，避免路径错误

内容来源于stack exchange