Flutter如何手动设置应用Locale实现应用内语言切换

完全可以实现应用级全局Locale切换，不需要依赖localeResolutionCallback做主动切换，该参数仅用于系统Locale的兜底匹配逻辑，本身不支持主动触发全局语言变更。核心实现方式是直接配置MaterialApp/CupertinoApp暴露的locale属性，结合状态管理完成全局状态刷新即可。

具体实现步骤 #

1. 实现全局Locale状态持有 #

使用轻量状态管理持有用户选中的Locale配置，不需要引入复杂依赖，用Flutter自带的ChangeNotifier即可满足需求：

class LocaleNotifier extends ChangeNotifier {
  Locale? _appLocale;
  // 对外暴露当前Locale，为null时默认跟随系统
  Locale? get currentLocale => _appLocale;

  /// 手动设置应用语言
  void updateLocale(Locale targetLocale) {
    _appLocale = targetLocale;
    notifyListeners();
  }

  /// 清除自定义设置，恢复跟随系统语言
  void resetToSystemLocale() {
    _appLocale = null;
    notifyListeners();
  }
}

2. 绑定状态到应用根组件 #

将状态容器放在应用顶层，把状态中存储的Locale直接赋值给MaterialApp的locale参数，你之前按照官方指南配置的localizationsDelegates、supportedLocales、localeResolutionCallback都不需要改动：

• 当locale参数传非空值时，Flutter会全局使用该Locale加载本地化资源，直接覆盖系统默认Locale
• 当locale参数传null时，会自动触发localeResolutionCallback逻辑，匹配系统当前最合适的语言，和你之前的默认运行逻辑一致

示例入口代码：

void main() {
  runApp(
    ChangeNotifierProvider(
      create: (_) => LocaleNotifier(),
      child: const MyApp(),
    )
  );
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    final localeState = context.watch<LocaleNotifier>();
    return MaterialApp(
      // 核心配置：绑定全局自定义Locale
      locale: localeState.currentLocale,
      // 以下配置保持你原有本地化配置不变即可
      localizationsDelegates: const [
        AppLocalizations.delegate,
        GlobalMaterialLocalizations.delegate,
        GlobalWidgetsLocalizations.delegate,
        GlobalCupertinoLocalizations.delegate,
      ],
      supportedLocales: const [
        Locale('en', ''),
        Locale('zh', 'CN'),
        // 其他你支持的语言
      ],
      home: const HomePage(),
    );
  }
}

3. 应用内触发语言切换 #

在语言设置页，用户选择对应语言后直接调用状态更新方法即可，组件会自动刷新加载对应语言资源：

// 切换到简体中文示例
context.read<LocaleNotifier>().updateLocale(const Locale('zh', 'CN'));

// 恢复跟随系统
context.read<LocaleNotifier>().resetToSystemLocale();

注意事项 #

如果需要持久化保存用户的语言选择（应用重启后保留配置），只需要在调用updateLocale时，将选中的语言编码、地区编码通过本地持久化方案存到本地，应用启动时先读取本地缓存给LocaleNotifier赋初始值即可。

之前调试localeResolutionCallback没有达到预期，是因为这个回调属于被动匹配逻辑，只会在App初始化、系统Locale发生变更且没有手动指定app级locale时触发，无法通过修改回调返回值主动触发全局语言刷新。

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