Android Compose：解决BasicTextField获焦点后键盘遮挡问题

核心方案：正确处理窗口Insets与布局层级 #

1. 给外层容器添加IME（输入法）内边距 #

在Compose 1.2及以上版本，直接使用Modifier.imePadding()扩展，它会自动在键盘弹出时给容器底部添加对应高度的内边距，确保输入框不被遮挡。将该修饰符添加到包裹输入框的外层Row上：

Row(
    modifier = Modifier
        .fillMaxWidth()
        .heightIn(min = 68.dp)
        .border(width = 1.dp, color = Color.Blue)
        .background(color = Color.White)
        .imePadding(), // 添加此行
    verticalAlignment = Alignment.Top
) {
    // 原有代码不变
}

若使用较低版本Compose，可替换为：

.windowInsetsPadding(WindowInsets.ime)

2. 移除干扰布局计算的offset修饰符 #

你代码中offset(y=8.dp)和decorationBox内Text的offset(y=-16.dp)会破坏Compose自动布局逻辑，导致Insets无法精准识别输入框位置。建议用padding替代offset调整元素位置：

BasicTextField(
    modifier = Modifier
        .padding(start = 16.dp, top = 28.dp, bottom = 16.dp) // 用top padding替代offset(y=8.dp)
        .weight(1f),
    // 其他参数不变
    decorationBox = {
        Text(
            modifier = Modifier.padding(bottom = 4.dp), // 用padding替代offset(y=-16.dp)
            text = "amount",
            fontSize = 12.sp,
            color = Color.Gray,
            fontWeight = FontWeight.Bold
        )
        it()
    },
)

3. 让输入框在可滚动容器中（推荐） #

如果输入框位于屏幕底部且需支持多行展开，建议将整体布局放在可滚动容器内，比如带垂直滚动的Column：

Column(
    modifier = Modifier
        .fillMaxSize()
        .verticalScroll(rememberScrollState())
        .imePadding() // 全局添加IME内边距
) {
    // 其他布局元素
    // 你的输入框Row代码放在此处
}

4. 检查Activity软输入模式（可选） #

若上述调整仍有问题，可在对应Activity的onCreate方法中设置窗口软输入模式，确保窗口随键盘弹出调整大小：

window.setSoftInputMode(WindowManager.LayoutParams.SOFT_INPUT_ADJUST_RESIZE)

调整后的完整代码示例 #

Row(
    modifier = Modifier
        .fillMaxWidth()
        .heightIn(min = 68.dp)
        .border(width = 1.dp, color = Color.Blue)
        .background(color = Color.White)
        .imePadding(),
    verticalAlignment = Alignment.Top
) {
    BasicTextField(
        modifier = Modifier
            .padding(start = 16.dp, top = 28.dp, bottom = 16.dp)
            .weight(1f),
        textStyle = TextStyle(fontSize = 24.sp, lineHeight = 37.sp),
        maxLines = 5,
        keyboardOptions = KeyboardOptions(keyboardType = KeyboardType.Number),
        value = input,
        onValueChange = {
            input = it
        },
        decorationBox = {
            Text(
                modifier = Modifier.padding(bottom = 4.dp),
                text = "amount",
                fontSize = 12.sp,
                color = Color.Gray,
                fontWeight = FontWeight.Bold
            )
            it()
        },
    )
    Row(modifier = Modifier.align(Alignment.CenterVertically)) {
        Image(
            modifier = Modifier.padding(start = 4.dp, end = 16.dp),
            painter = painterResource(id = R.drawable.arrow_down),
            contentDescription = null,
            colorFilter = ColorFilter.tint(color = Color.Blue)
        )
    }
}

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