如何使用Jetpack Compose实现无需修改系统语言的应用内本地化

该方案完全不需要修改设备系统语言，所有配置仅在当前应用进程内生效，适配所有Android 8.0及以上版本系统，可直接落地使用。

一、基础资源准备 #

• 按照Android原生本地化规范存放多语言字符串资源：默认语言资源放在res/values/strings.xml，其他语言对应放在带语言后缀的资源目录下，比如简体中文对应res/values-zh/strings.xml，阿拉伯语对应res/values-ar/strings.xml，和常规本地化的资源配置逻辑完全一致。
• 所有Compose页面中展示的文本必须通过stringResource(id = R.string.xxx)获取，禁止硬编码文本，否则切换语言后不会自动更新。

二、持久化存储用户语言选择 #

用轻量存储记录用户选中的语言标识，应用启动时优先读取该配置，未配置时默认跟随系统语言。以SharedPreferences实现为例，代码如下：

object LanguageStore {
    private const val SP_NAME = "app_runtime_config"
    private const val KEY_SELECTED_LANG = "selected_lang_code"

    fun saveLang(context: Context, langCode: String) {
        context.getSharedPreferences(SP_NAME, Context.MODE_PRIVATE)
            .edit()
            .putString(KEY_SELECTED_LANG, langCode)
            .apply()
    }

    fun getSavedLang(context: Context): String? {
        return context.getSharedPreferences(SP_NAME, Context.MODE_PRIVATE)
            .getString(KEY_SELECTED_LANG, null)
    }

    fun clearLangSetting(context: Context) {
        context.getSharedPreferences(SP_NAME, Context.MODE_PRIVATE)
            .edit()
            .remove(KEY_SELECTED_LANG)
            .apply()
    }
}

三、全局Context语言配置注入 #

核心逻辑是在Context创建阶段替换资源配置中的Locale参数，让整个应用的资源加载都使用用户选中的语言，而非系统语言。

1. 首先写一个Context扩展方法，统一处理语言配置包装：

fun Context.applyLanguageConfig(langCode: String?): Context {
    // 无自定义语言配置时直接返回原Context，默认跟随系统
    langCode ?: return this
    val targetLocale = Locale(langCode)
    Locale.setDefault(targetLocale)

    val resourceConfig = resources.configuration
    resourceConfig.setLocale(targetLocale)
    // 自动适配RTL语言（如阿拉伯语、希伯来语）的布局方向
    resourceConfig.setLayoutDirection(targetLocale)

    return createConfigurationContext(resourceConfig)
}

2. 在承载Compose内容的Activity中重写attachBaseContext方法，在Context创建时注入语言配置：

class MainActivity : ComponentActivity() {
    override fun attachBaseContext(newBase: Context) {
        val savedLang = LanguageStore.getSavedLang(newBase)
        super.attachBaseContext(newBase.applyLanguageConfig(savedLang))
    }

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContent {
            // 这里放你的Compose根布局、导航、主题等内容
            YourAppTheme {
                AppNavHost()
            }
        }
    }
}

注意：单Activity架构仅需要处理这一个Activity即可；如果是多Activity架构，所有Activity都要重写attachBaseContext做相同处理，否则跳转后会恢复系统语言。如果自定义了Application类，也需要在Application的attachBaseContext中做相同配置，避免Application上下文取到的字符串不匹配当前语言。

四、语言切换触发逻辑 #

在Compose页面中添加语言选择入口，用户选中对应语言后，先持久化存储选择结果，再重启Activity清空返回栈，让新的语言配置全局生效，示例代码如下：

@Composable
fun LanguageSelectPage() {
    val context = LocalContext.current
    Column(
        modifier = Modifier
            .fillMaxSize()
            .padding(16.dp)
    ) {
        Text(
            text = "应用语言设置",
            style = MaterialTheme.typography.headlineSmall
        )
        Spacer(modifier = Modifier.height(32.dp))

        // 简体中文选项
        Button(
            onClick = {
                LanguageStore.saveLang(context, "zh")
                restartActivity(context)
            },
            modifier = Modifier.fillMaxWidth()
        ) {
            Text("简体中文")
        }

        Spacer(modifier = Modifier.height(12.dp))

        // 英文选项
        Button(
            onClick = {
                LanguageStore.saveLang(context, "en")
                restartActivity(context)
            },
            modifier = Modifier.fillMaxWidth()
        ) {
            Text("English")
        }

        Spacer(modifier = Modifier.height(12.dp))

        // 跟随系统选项
        OutlinedButton(
            onClick = {
                LanguageStore.clearLangSetting(context)
                restartActivity(context)
            },
            modifier = Modifier.fillMaxWidth()
        ) {
            Text("跟随系统")
        }
    }
}

// 重启Activity的通用方法
private fun restartActivity(context: Context) {
    val intent = Intent(context, MainActivity::class.java)
    intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK or Intent.FLAG_ACTIVITY_CLEAR_TASK)
    context.startActivity(intent)
    (context as? Activity)?.finish()
    // 可选：加Activity切换动画，避免重启生硬
    context.overridePendingTransition(android.R.anim.fade_in, android.R.anim.fade_out)
}

常见问题说明 #

• 该方案是Android官方支持的应用级配置替换逻辑，不需要申请任何特殊权限，在Android 8.0到Android 14的所有正式版本上均可正常运行
• 不需要额外处理Configuration变更的重组逻辑，Activity重启后所有Compose页面会自动加载对应语言的资源
• 如果需要适配Appcompat相关的兼容组件，只需要在包装Context后调用AppCompatDelegate.setApplicationLocales()同步配置即可，纯Compose项目不需要这一步

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