Jetpack Compose开发：如何向视图树下层可组合项传递值？

针对视图树多层组件传参冗长的问题，Compose生态有三类成熟的落地方案可以按需选用：

1. CompositionLocal 隐式传值 #

这是Compose官方提供的原生跨层传值能力，无需显式逐层传递参数即可让下层节点读取上层提供的值。

• 适用场景：需要在视图树大范围共享、变更频率低的数据，比如全局主题配置、用户登录态、地域配置等。
• 使用示例：

// 第一步：定义CompositionLocal实例，变更少的场景用staticCompositionLocalOf
val LocalCommonConfig = staticCompositionLocalOf<CommonConfig> {
    error("CommonConfig not provided")
}

// 第二步：在上层节点提供值，内部所有子节点都可读取
CompositionLocalProvider(LocalCommonConfig provides currentConfig) {
    RootComposable()
}

// 第三步：任意下层节点直接读取，不需要逐层传参
@Composable
fun DeepChildComposable() {
    val config = LocalCommonConfig.current
    // 直接使用即可
}

• 注意事项：不要用于频繁变更的数据，否则会产生不必要的重组开销；隐式传递会降低组件依赖的可读性，不要滥用。

2. 状态容器封装 #

将同业务域的零散参数、回调方法封装到同一个状态类中，只需传递一个参数即可替代多个零散参数，大幅缩短参数列表。

• 适用场景：同一功能模块内的多层组件传参，参数之间关联性强、属于同一业务域。
• 使用示例：

// 封装状态容器，统一管理所有相关状态和回调
data class GoodsListState(
    val goodsList: List<GoodsItem>,
    val isLoading: Boolean,
    val onItemClick: (GoodsItem) -> Unit,
    val onLoadMore: () -> Unit
)

// 上层只需要传递一个状态参数
@Composable
fun GoodsListScreen(state: GoodsListState) {
    GoodsListContent(state = state)
}

// 下层直接使用状态容器内的所有属性和方法
@Composable
fun GoodsListContent(state: GoodsListState) {
    if (state.isLoading) {
        LoadingView()
    } else {
        LazyColumn {
            items(state.goodsList) { item ->
                GoodsItem(item, onClick = { state.onItemClick(item) })
            }
        }
    }
}

如果是业务逻辑较重的场景，也可以直接将ViewModel作为状态容器传递，ViewModel生命周期和页面绑定，内部的状态和业务方法可以直接在所有下层组件调用。

3. 单向数据流 + 事件冒泡 #

针对回调参数过多的场景，采用单向数据流架构，所有状态都在上层统一管理，下层组件只负责发送事件，不需要持有回调参数，事件向上冒泡到上层统一处理后再更新状态向下同步。

• 适用场景：多层级回调透传场景，减少回调参数的传递层数。

选型建议：
跨多模块共享的低频变更数据优先使用CompositionLocal
同业务域零散参数优先封装为状态容器
高频变更的业务状态优先使用ViewModel+单向数据流管理

内容的提问来源于stack exchange，提问作者AbdulMomen عبدالمؤمن