Flutter开发中如何在TextFormField内使用AppLocalization？

要在TextFormField中正确接入AppLocalization实现多语言，核心是保证获取本地化实例的BuildContext已经正确挂载了多语言代理，以下是可直接复用的实现方式和避坑点：

前置检查 #

先确认基础多语言配置已经生效：

• pubspec.yaml中已引入flutter_localizations依赖，且开启了arb代码生成配置
• 根MaterialApp/CupertinoApp中已经配置了localizationsDelegates列表、supportedLocales列表，手动切语言的场景还要额外配置locale回调

具体调用方式 #

TextFormField里所有需要本地化的文本（提示文案、标签、校验错误、辅助文案等），都可以直接通过上下文拿AppLocalization实例读取对应key的文案：

1. 输入框装饰类文本（hint/label/helper）

直接在InputDecoration的对应属性中调用即可：

TextFormField(
  keyboardType: TextInputType.phone,
  decoration: InputDecoration(
    // 占位提示
    hintText: AppLocalizations.of(context)!.inputPhoneHint,
    // 悬浮标签
    labelText: AppLocalizations.of(context)!.phoneNumberLabel,
    // 底部辅助说明
    helperText: AppLocalizations.of(context)!.phoneFormatHint,
  ),
)

如果你给BuildContext封装了本地化扩展方法（比如官方生成代码自带的快捷访问），可以简化写法，效果完全一致：

// 扩展方法等价于AppLocalizations.of(context)!
decoration: InputDecoration(
  hintText: context.l10n.inputPhoneHint,
)

2. 表单校验错误文本

validator回调中可以直接拿到可用的上下文，不需要额外传参，直接读取本地化文案即可：

TextFormField(
  obscureText: true,
  decoration: InputDecoration(
    labelText: AppLocalizations.of(context)!.passwordLabel,
  ),
  validator: (inputValue) {
    if (inputValue == null || inputValue.trim().isEmpty) {
      return AppLocalizations.of(context)!.passwordEmptyError;
    }
    if (inputValue.length < 6) {
      return AppLocalizations.of(context)!.passwordLengthError;
    }
    return null;
  },
)

常见避坑点 #

• 不要在initState生命周期里提前获取AppLocalization实例，此时组件尚未完成挂载，多语言代理还未绑定到当前上下文，会获取到null导致报错。如果需要提前缓存文案，放到didChangeDependencies生命周期中获取即可。
• 不要把AppLocalization实例存为全局静态变量长期持有，切换应用语言时静态实例不会自动更新，必须每次通过上下文获取最新实例，才能保证文案跟着语言设置实时刷新。
• 如果是手动切换应用语言的场景，确保根组件的locale参数已经同步更新为选中的语言，否则上下文拿到的还是旧语言的实例。

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