Flutter 国际化(i18n)全指南:一键切换中/英/日多语言
2026/5/3 17:59:42 网站建设 项目流程

一、为什么需要国际化?

如果你的应用面向全球用户,多语言支持是基本要求。Flutter 官方提供了强大的flutter_localizations包,配合intl工具,可轻松实现多语言切换。


二、快速上手:三步实现中英文切换

步骤 1:添加依赖

yaml

编辑

# pubspec.yaml dependencies: flutter: sdk: flutter flutter_localizations: sdk: flutter intl: ^0.19.0

步骤 2:配置 MaterialApp

dart

编辑

import 'package:flutter_localizations/flutter_localizations.dart'; void main() => runApp(const MyApp()); class MyApp extends StatelessWidget { const MyApp({super.key}); @override Widget build(BuildContext context) { return MaterialApp( localizationsDelegates: const [ GlobalMaterialLocalizations.delegate, GlobalWidgetsLocalizations.delegate, GlobalCupertinoLocalizations.delegate, ], supportedLocales: const [ Locale('en', ''), // 英语 Locale('zh', ''), // 中文 Locale('ja', ''), // 日语 ], home: HomePage(), ); } }

步骤 3:使用AppLocalizations

dart

编辑

// 获取当前语言文本 Text(AppLocalizations.of(context)!.helloWorld)

⚠️ 但此时会报错:缺少AppLocalizations类!


三、生成多语言资源文件(关键步骤)

1. 创建l10n.yaml文件(项目根目录)

yaml

编辑

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

2. 创建语言文件

  • lib/l10n/app_en.arb

    json

    编辑

    { "helloWorld": "Hello World", "welcomeMessage": "Welcome, {name}!" }
  • lib/l10n/app_zh.arb

    json

    编辑

    { "helloWorld": "你好,世界", "welcomeMessage": "欢迎,{name}!" }
  • lib/l10n/app_ja.arb

    json

    编辑

    { "helloWorld": "こんにちは、世界", "welcomeMessage": "ようこそ、{name}さん!" }

3. 生成代码

bash

编辑

flutter gen-l10n

✅ 自动生成app_localizations.dart,无需手动编写!


四、动态切换语言(带保存)

dart

编辑

// 切换语言并重启应用 void changeLanguage(BuildContext context, String locale) { final MyAppState? state = context.findAncestorStateOfType<MyAppState>(); if (state != null) { state.setLocale(Locale(locale)); } } // 在 MyApp 中管理状态 class MyApp extends StatefulWidget { const MyApp({super.key}); @override State<MyApp> createState() => MyAppState(); } class MyAppState extends State<MyApp> { late Locale _locale; @override void initState() { super.initState(); _locale = const Locale('zh'); // 默认中文 } void setLocale(Locale locale) { setState(() { _locale = locale; }); } @override Widget build(BuildContext context) { return MaterialApp( locale: _locale, // ...其他配置同上 ); } }

💡 可结合shared_preferences保存用户选择。


五、实际效果展示

语言截图
中文
English
日本語

📌 支持参数化文本:AppLocalizations.of(context)!.welcomeMessage('张三')


六、高级技巧

  1. 复数形式(如 “1 item” vs “2 items”):

    arb

    编辑

    "itemCount": "{count, plural, =0{无项目} =1{1个项目} other{{count}个项目}}"
  2. 日期/数字本地化

    dart

    编辑

    DateFormat.yMMMd().format(DateTime.now()); // 自动适配语言格式
  3. RTL 语言支持(如阿拉伯语):

    dart

    编辑

    MaterialApp( supportedLocales: [Locale('ar')], localizationsDelegates: [...], theme: ThemeData(useMaterial3: true), )

    Flutter 会自动镜像布局!


七、结语

国际化不再是“附加功能”,而是产品出海的必备能力。Flutter 的gen-l10n工具链让多语言开发变得简单高效。

完整示例代码:github.com/yourname/flutter-i18n-demo

如果你正在做全球化 App,不妨现在就集成 i18n!


需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询