操作说明

1. 配置依赖项 更新 pubspec.yaml 以包含所需的包并启用代码生成。

   dependencies: flutter: sdk: flutter flutter_localizations: sdk: flutter intl: any

   flutter: generate: true

2. 配置代码生成 在项目根目录中创建一个 l10n.yaml 文件，以定义本地化工具的行为。

   arb-dir: lib/l10n template-arb-file: app_en.arb output-localization-file: app_localizations.dart synthetic-package: false

3. 定义支持的区域设置 请暂停并询问用户： “您希望支持哪些语言和地区？请提供语言代码列表（例如 'en', 'es', 'zh_Hans_CN'）。”

4. 创建 ARB 文件 生成模板 .arb 文件（例如 lib/l10n/app_en.arb）和相应的翻译文件。根据需要实现占位符、复数和选择器。

   { "helloWorld": "Hello World!", "@helloWorld": { "description": "标准问候语" }, "greeting": "Hello {userName}", "@greeting": { "description": "带参数的问候语", "placeholders": { "userName": { "type": "String" } } }, "nWombats": "{count, plural, =0{no wombats} =1{1 wombat} other{{count} wombats}}", "@nWombats": { "placeholders": { "count": { "type": "num", "format": "compact" } } } }

5. 初始化根应用 导入生成的本地化文件并配置根 MaterialApp 或 CupertinoApp。

   import 'package:flutter_localizations/flutter_localizations.dart'; import 'package:your_app_name/l10n/app_localizations.dart'; // 根据 synthetic-package 设置调整路径

   // 在根部件的构建方法中： return MaterialApp( title: 'Localized App', localizationsDelegates: const [ AppLocalizations.delegate, GlobalMaterialLocalizations.delegate, GlobalWidgetsLocalizations.delegate, GlobalCupertinoLocalizations.delegate, ], supportedLocales: const [ Locale('en', ''), // 英语 Locale('es', ''), // 西班牙语 Locale.fromSubtags(languageCode: 'zh', scriptCode: 'Hans', countryCode: 'CN'), ], home: const MyHomePage(), );

6. 处理独立部件（如适用） 如果 TextField 或 CupertinoTabBar 抛出缺少 MaterialLocalizations 或 Localizations 祖先的错误，请在其正上方直接注入一个 Localizations 部件。

   Localizations( locale: const Locale('en', 'US'), delegates: const <LocalizationsDelegate<dynamic>>[ DefaultWidgetsLocalizations.delegate, DefaultMaterialLocalizations.delegate, DefaultCupertinoLocalizations.delegate, ], child: CupertinoTabBar( items: const <BottomNavigationBarItem>[...], ), )

7. 配置 iOS 项目 请暂停并询问用户： “此项目是否针对 iOS？如果是，我将提供更新 Xcode 项目的说明。” 如果是，请指导用户执行以下操作：

 1. 在 Xcode 中打开 `ios/Runner.xcodeproj`。

 2. 在项目导航器中选择 `Runner` 项目。
 3. 转到 `Info` 选项卡。
 4. 在 **Localizations** 下，点击 `+` 添加所有支持的语言。

8. 验证与修复 运行 flutter gen-l10n。验证 app_localizations.dart 是否成功生成。如果编译失败并出现“未找到 MaterialLocalizations”或“CupertinoTabBar 需要一个 Localizations 父部件”的错误，请从出错的部件开始向上遍历部件树，并确保正确提供了 localizationsDelegates。

约束条件

• 不使用合成包： 如果用户环境需要直接生成源代码，请确保考虑 synthetic-package: false，或者对于现代 Flutter 版本，依赖标准的 generate: true 行为。如果设置了 synthetic-package: false，则不要使用 package:flutter_gen 导入。
• 部件要求： TextField 必须 有一个 MaterialLocalizations 祖先。CupertinoTabBar 必须 有一个 Localizations 祖先。
• 复杂区域设置： 对于需要脚本代码的语言（例如中文 zh_Hans、zh_Hant），始终 使用 Locale.fromSubtags。
• ARB 语法： 确保在 .arb 字符串中使用的所有占位符都在相应的 @ 元数据对象中明确定义。
• 转义： 如果 .arb 文件中需要字面量花括号 {} 或单引号 '，请在 l10n.yaml 中启用 use-escaping: true，并使用连续的单引号 '' 进行转义。

每周安装量

978

代码仓库

flutter/skills

GitHub 星标数

792

首次出现

2026年3月4日

安全审计

Gen Agent Trust HubPassSocketPassSnykPass

已安装于

codex950

opencode946

cursor946

gemini-cli945

github-copilot945

kimi-cli943

{
  "helloWorld": "Hello World!",
  "@helloWorld": {
    "description": "Standard greeting"
  },
  "greeting": "Hello {userName}",
  "@greeting": {
    "description": "Greeting with a parameter",
    "placeholders": {
      "userName": {
        "type": "String"
      }
    }
  },
  "nWombats": "{count, plural, =0{no wombats} =1{1 wombat} other{{count} wombats}}",
  "@nWombats": {
    "placeholders": {
      "count": {
        "type": "num",
        "format": "compact"
      }
    }
  }
}