Compose预览渲染失败：使用stringRes()加载资源字符串报错

当你在Compose预览里用stringRes()加载资源字符串时，预览环境没初始化这个方法依赖的CompositionLocal（一般是提供资源访问的上下文或资源管理器），所以会抛出「Failed to instantiate Composition local；This preview was unable to find a CompositionLocal」的错误。下面是几种实用的解决方式：

1. 手动给预览补全CompositionLocal实例 #

如果stringRes()是你自己封装的、依赖某个CompositionLocal（比如LocalContext）的方法，直接在预览Composable外层用CompositionLocalProvider注入所需实例就行。

举个实际例子：
假设你的stringRes()是这么写的：

@Composable
fun stringRes(id: Int): String {
    val resources = LocalContext.current.resources
    return resources.getString(id)
}

那预览代码可以改成这样：

@Preview
@Composable
fun MyScreenPreview() {
    CompositionLocalProvider(LocalContext provides LocalContext.current) {
        MyScreen()
    }
}

或者更简单，直接在预览里提前拿到字符串传进去：

@Preview
@Composable
fun MyScreenPreview() {
    val testTitle = LocalContext.current.getString(R.string.app_name)
    MyScreen(title = testTitle)
}

2. 换成Compose原生的stringResource() #

要是你的stringRes()只是简单封装了资源加载，直接改用Jetpack Compose自带的stringResource()就行——它已经适配了预览环境，不需要额外处理CompositionLocal：

// 把自定义的stringRes()替换成这个
Text(text = stringResource(R.string.your_target_string))

3. 给预览提供模拟的资源实现 #

如果必须用自定义的stringRes()，可以给预览单独加个模拟的CompositionLocal实现，比如：

// 假设你有自定义的LocalStringRes
val LocalStringRes = compositionLocalOf<(Int) -> String> { error("String resolver not provided") }

@Preview
@Composable
fun MyScreenPreview() {
    // 预览时返回固定字符串
    val mockStringResolver = { _: Int -> "预览测试文本" }
    CompositionLocalProvider(LocalStringRes provides mockStringResolver) {
        MyScreen()
    }
}

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