Flutter切换Locale后MaterialApp不重建，仅热重载生效问题求助

核心原因 #

虽然LanguageBloc的状态已经更新并触发了BlocBuilder的重建，但MaterialApp因实例复用机制，没有重新加载对应Locale的本地化资源，导致文本未实时更新——热重载时会强制重新加载资源，所以此时文本能正常显示。

解决方案 #

1. 给MaterialApp绑定唯一Key，强制触发重建 #

用当前Locale的code作为ValueKey，让Flutter识别到MaterialApp需要完全重建，而非复用旧实例，从而触发本地化委托重新加载对应语言资源：

return MaterialApp.router(
  // 通过语言code绑定唯一Key，Locale变化时强制重建MaterialApp
  key: ValueKey(languageState.currentLanguage.code),
  routerConfig: _routerConfig,
  locale: Locale.fromSubtags(languageCode: languageState.currentLanguage.code),
  localizationsDelegates: const [
    S.delegate,
    GlobalMaterialLocalizations.delegate,
    GlobalWidgetsLocalizations.delegate,
    GlobalCupertinoLocalizations.delegate,
  ],
  supportedLocales: S.delegate.supportedLocales,
  builder: BotToastInit(),
);

2. 避免重复创建RouterConfig #

将路由配置的初始化移到initState中，防止每次build都生成新的路由实例，避免路由栈意外重置：

class _MyAppState extends State<MyApp> {
  late final AppRouter _appRouter;
  late final ThemeBloc _themeBloc;
  late final LanguageBloc _languageBloc;
  late final RouterConfig<Object> _routerConfig;

  @override
  void initState() {
    super.initState();
    _appRouter = dependencies.get();
    _themeBloc = dependencies.get();
    _languageBloc = dependencies.get();
    // 仅初始化一次路由配置
    _routerConfig = _appRouter.config();
  }

  @override
  Widget build(final BuildContext context) {
    return BlocBuilder<ThemeBloc, ThemeState>(
      bloc: _themeBloc,
      builder: (BuildContext context, ThemeState themeState) {
        return AppThemeWidget(
          theme: themeState.theme,
          child: BlocBuilder<LanguageBloc, LanguageState>(
            bloc: _languageBloc,
            builder: (BuildContext context, LanguageState languageState) {
              print(languageState.currentLanguage.code);

              return MaterialApp.router(
                key: ValueKey(languageState.currentLanguage.code),
                routerConfig: _routerConfig,
                locale: Locale.fromSubtags(languageCode: languageState.currentLanguage.code),
                localizationsDelegates: const [
                  S.delegate,
                  GlobalMaterialLocalizations.delegate,
                  GlobalWidgetsLocalizations.delegate,
                  GlobalCupertinoLocalizations.delegate,
                ],
                supportedLocales: S.delegate.supportedLocales,
                builder: BotToastInit(),
              );
            },
          ),
        );
      },
    );
  }
}

3. 确保状态类的相等性判断正确 #

如果LanguageState或Language类没有正确重写==和hashCode，BlocBuilder可能无法识别状态变化（虽已通过print确认状态更新，但仍需保障这一基础逻辑）：

用Equatable简化实现（需添加equatable: ^2.0.5依赖）

class LanguageState extends Equatable {
  final Language currentLanguage;

  const LanguageState({required this.currentLanguage});

  @override
  List<Object> get props => [currentLanguage];
}

class Language extends Equatable {
  final String code;

  const Language({required this.code});

  @override
  List<Object> get props => [code];
}

手动重写相等性判断

class LanguageState {
  final Language currentLanguage;

  const LanguageState({required this.currentLanguage});

  @override
  bool operator ==(Object other) =>
      identical(this, other) ||
      other is LanguageState &&
          runtimeType == other.runtimeType &&
          currentLanguage == other.currentLanguage;

  @override
  int get hashCode => currentLanguage.hashCode;
}

class Language {
  final String code;

  const Language({required this.code});

  @override
  bool operator ==(Object other) =>
      identical(this, other) ||
      other is Language &&
          runtimeType == other.runtimeType &&
          code == other.code;

  @override
  int get hashCode => code.hashCode;
}

验证逻辑 #

添加Key后，每次Locale变化都会触发MaterialApp完全重建，S.delegate会重新加载对应语言的本地化资源，文本即可实时更新，无需依赖热重载。

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