本文详解在 android 12+（targetsdkversion 31）环境下，通过代码动态切换应用语言时 fragment 未同步更新的根本原因与完整解决方案，涵盖 configuration 更新机制、activity 重建局限性及推荐的基类统一管理策略。
本文详解在 android 12+（targetsdkversion 31）环境下，通过代码动态切换应用语言时 fragment 未同步更新的根本原因与完整解决方案，涵盖 configuration 更新机制、activity 重建局限性及推荐的基类统一管理策略。
在 Android 中动态切换语言（如从 English 切换到 Français）看似只需调用 config.setLocale() + updateConfiguration() + recreate()，但实际运行中常出现「主 Activity 文本更新了，而嵌套的 Fragment 或后续打开的 Activity 仍显示旧语言」的问题——这正是你遇到的现象：replaceFragment() 加载的新 Fragment 未应用新语言。
根本原因在于：resources.updateConfiguration() 仅影响当前 Activity 的 Resources 实例，且其效果不会自动继承或传播到 Fragment、新启动的 Activity，甚至在某些 API 级别下对 Fragment 的 onCreateView() 中的 inflater 也无效。尤其在 targetSdkVersion ≥ 31（Android 12+）后，系统进一步强化了配置隔离性，setLocale() 已被弃用，必须使用 setLocales(new LocaleList(locale))，且 updateConfiguration() 的行为更严格。
✅ 正确做法（兼容 API 21+，适配 SDK 31+）：
// 推荐封装为工具方法（例如 LanguageUtils.java）
public static void applyLanguage(@NonNull Activity activity, @NonNull String languageCode) {
Locale locale = new Locale(languageCode);
LocaleList localeList = new LocaleList(locale);
Resources resources = activity.getResources();
Configuration config = resources.getConfiguration();
// Android 7.0+ 使用 setLocales；Android < 7.0 回退 setLocale
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
config.setLocales(localeList);
// 注意：Android 12+（SDK 31+）强制要求同时设置 setLocale() 以兼容部分系统组件
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
config.setLocale(locale); // 兼容性兜底
}
} else {
config.setLocale(locale);
}
// 必须传入 DisplayMetrics（否则字体缩放等可能异常）
resources.updateConfiguration(config, resources.getDisplayMetrics());
}⚠️ 关键注意事项：
在调试 Java 后端 API 故障时使用此技能，尤其适用于以下任务：分析日志、跨 Controller、Service 和 Mapper 层追踪请求、定位异常根因、检查 SQL 执行或参数流转，以及生成简洁的诊断结论与修复方案。
立即学习“Java免费学习笔记（深入）”；
- activity.recreate() 只重建当前 Activity，不触发已加载 Fragment 的 onConfigurationChanged()，也不会重新 inflate 其视图。Fragment 内部若缓存了 getString(R.string.xxx) 结果，或使用了 LayoutInflater.from(context) 创建的 View，将仍显示旧语言。
- Fragment 必须主动响应语言变更：在 Fragment 中重写 onConfigurationChanged() 并手动刷新 UI（如 textView.setText(getString(R.string.hello))），或在 onViewCreated() 中延迟获取字符串（确保此时 Configuration 已更新）。
- 更健壮的方案是：所有 Activity 统一继承自一个 BaseActivity，在其 onResume() 中检查并应用当前首选语言：
public abstract class BaseActivity extends AppCompatActivity {
@Override
protected void onResume() {
super.onResume();
String savedLang = PreferenceManager.getDefaultSharedPreferences(this)
.getString("app_language", "en");
LanguageUtils.applyLanguage(this, savedLang);
// 若语言已变更，强制刷新 ActionBar/Toolbar 标题等
invalidateOptionsMenu();
}
}然后让 MainActivity 及所有其他 Activity 继承 BaseActivity。Fragment 则可通过 requireActivity().getString() 安全获取最新字符串，避免本地缓存。
? 总结：
动态切语言不是“一次设置，全局生效”的操作。它本质是修改每个 Context 的资源配置，因此必须确保：
① 每个 Activity 在生命周期关键点（如 onResume）应用配置；
② Fragment 不依赖静态字符串缓存，而应在 onCreateView() 或 onViewCreated() 中实时调用 getString()；
③ 避免在 Application 类中调用 updateConfiguration()（无效且不安全）；
④ 使用 LocaleList 替代单 Locale，并针对 Android 12+ 做兼容处理。
遵循此模式，即可实现真正一致、可维护的多语言切换体验。
