为何使用Modifier.weight需外层布局包裹才不报错？

我在学习Android Compose基础布局的Codelab时，遇到一个奇怪的问题：直接给Row布局添加Modifier.weight(1f)会编译报错Unresolved reference: weight，但把这个Row包裹在Column里面后，weight修饰符就能正常工作。想搞清楚这两种写法的本质区别。

报错的代码 #

@Composable
fun ComposeRowWithWeightAndColumns(modifier: Modifier = Modifier)
{
    Row(Modifier.weight(1f)) { // 此处报错：Unresolved reference: weight
        Column(
            horizontalAlignment = Alignment.CenterHorizontally,
            verticalArrangement = Arrangement.Center
        ) {
            ComposeCard("Android0", "Body0", 0)
            ComposeCard("Android2", "Body2", 2)
        }
        Column(
            horizontalAlignment = Alignment.CenterHorizontally,
            verticalArrangement = Arrangement.Center
        ) {
            ComposeCard("Android1", "Body randomX", 1)
            ComposeCard("Android3", "Body random", 3)
        }
    }
}

正常运行的代码 #

@Composable
fun ComposeColumnWithRowAndColumns(modifier: Modifier = Modifier)
{
    Column(Modifier.fillMaxWidth()) {
        Row(Modifier.weight(1f)) { // 此处无报错
            Column(
                horizontalAlignment = Alignment.CenterHorizontally,
                verticalArrangement = Arrangement.Center
            ) {
                ComposeCard("Android0", "Body0", 0)
                ComposeCard("Android2", "Body2", 2)
            }
            Column(
                horizontalAlignment = Alignment.CenterHorizontally,
                verticalArrangement = Arrangement.Center
            ) {
                ComposeCard("Android1", "Body randomX", 1)
                ComposeCard("Android3", "Body random", 3)
            }
        }
    }
}

本质原因：Modifier.weight的作用域限制 #

Modifier.weight并不是全局可用的修饰符，它是ColumnScope和RowScope下的扩展函数——只有当一个Composable是Column或Row的直接子元素时，才能调用这个修饰符。

• 第一种写法中，Row没有被Column/Row这类容器包裹，它的父布局不是支持weight计算的布局容器，此时Row不在ColumnScope/RowScope的作用域内，自然找不到weight这个扩展函数，所以编译报错。
• 第二种写法中，Row是Column的直接子元素，此时Row处于ColumnScope的作用域中，weight修饰符可以正常调用，它的作用是告诉Column：这个Row在垂直方向（Column的主轴）占据剩余的全部可用空间（权重1f）。

Stack Overflow提到的"Row/Column支持Modifier.weight"，指的是它们的子元素可以通过weight来分配主轴方向的空间，而不是说Row/Column自身可以脱离父容器直接使用weight修饰符。

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