Compose布局问题：键盘弹出/小屏设备上内容无法滚动

问题背景 #

开发包含两个输入框和登录按钮的登录表单时，遇到以下问题：

• 弹出键盘后内容无法滚动，无法选中第二个输入框或点击登录按钮
• 小屏设备上底部内容直接截断，完全无法滚动
• 已尝试为Column添加verticalScroll、imePadding，Manifest中设置android:windowSoftInputMode="adjustResize"，但均未生效
• 移除子元素的weight修饰符，或把父布局Column替换为ConstraintLayout后，滚动恢复正常，但不清楚Column布局的问题根源

问题原因 #

核心冲突在于**weight修饰符与verticalScroll的布局逻辑不兼容**：

1. 当Column设置verticalScroll后，它不再是固定高度的容器，而是由子元素总高度决定的可滚动容器，其高度会随内容动态变化
2. weight修饰符的作用是让子元素在父容器的剩余固定空间中按比例分配高度，这个逻辑只适用于固定高度的容器
3. 给两个子Column都设置weight(0.5f)，会强制它们拉伸到父容器初始高度的一半，当键盘弹出或屏幕较小时，子元素实际高度超过显示区域，但滚动逻辑因为weight的干扰，无法正确计算可滚动范围，最终导致内容截断、无法滚动

解决方案 #

方案1：移除子元素的weight修饰符 #

改用Spacer、固定高度或padding来控制布局间距，让Column能正确计算总高度，恢复滚动功能：

@Composable
fun LoginScreen() {
    val scrollState = rememberScrollState()
    Column(
        modifier = Modifier
            .fillMaxSize()
            .imePadding()
            .verticalScroll(scrollState),
        horizontalAlignment = Alignment.CenterHorizontally
    ) {
        // 顶部占位，控制logo区的垂直位置
        Spacer(modifier = Modifier.weight(1f))

        Column(
            verticalArrangement = Arrangement.Center,
            horizontalAlignment = Alignment.CenterHorizontally
        ) {
            Image(
                modifier = Modifier.size(120.dp),
                painter = painterResource(R.mipmap.default_logo),
                contentDescription = "应用Logo"
            )

            Icon(
                modifier = Modifier.width(200.dp),
                painter = painterResource(com.roar.featureui.login.R.drawable.ic_title),
                contentDescription = "应用标题",
                tint = MaterialTheme.colorScheme.primary
            )
        }

        // 分隔logo区和登录表单
        Spacer(modifier = Modifier.weight(1f))

        LoginCardContent(
            modifier = Modifier.padding(horizontal = 32.dp),
            username = "Daniel",
            usernameChanged = {},
            password = "Blah",
            passwordChanged = {},
            loading = false,
            onLoginPressed = {}
        )

        // 底部留间距，避免表单被键盘完全遮挡
        Spacer(modifier = Modifier.height(32.dp))
    }
}

方案2：改用ConstraintLayout作为父容器 #

ConstraintLayout通过约束关系精准控制元素位置，避免weight在可滚动容器中的逻辑冲突，这也是测试后有效的方案。

注意事项 #

• 给可滚动容器（如带verticalScroll的Column）的子元素设置weight时要谨慎，因为可滚动容器的高度是动态的，weight的比例分配逻辑不适用
• imePadding必须添加在可滚动容器的Modifier上，才能在键盘弹出时正确调整滚动区域的padding

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