Jetpack Compose 中屏幕底部TextField被软键盘遮挡如何解决？

在Jetpack Compose开发中使用TextField组件时，若TextField位于屏幕靠近底部的位置，唤起软键盘后该组件会被软键盘遮挡无法正常显示。

已尝试的排查方案 #

• 修改Activity配置的android:windowSoftInputMode="adjustPan"和android:windowSoftInputMode="adjustResize"属性
• 使用adjustPan配置时，TextField仅有时会跟随软键盘一同上移显示，其余场景仍会被遮挡

问题复现截图 #

1. 首先确认AndroidManifest.xml中对应Activity的配置，固定使用adjustResize即可，adjustPan的窗口平移逻辑不受Compose控制，出现概率性遮挡属于原生机制的正常现象：

<activity
    android:name=".YourActivity"
    android:windowSoftInputMode="adjustResize" />

同时检查Activity使用的主题，确认没有配置android:windowFullscreen = true，全屏模式下adjustResize会直接失效。

2. 若使用Jetpack Compose 1.2.0及以上版本，直接给页面根布局/包含输入框的滚动容器添加imePadding()修饰符即可，该修饰符会自动根据软键盘的显隐调整底部间距，保证聚焦的输入框不会被遮挡：

// 示例：给可滚动的Column添加imePadding
Column(
    modifier = Modifier
        .fillMaxSize()
        .verticalScroll(rememberScrollState())
        .imePadding() // 关键配置
) {
    // 其他页面组件
    TextField(
        value = text,
        onValueChange = { text = it },
        modifier = Modifier.fillMaxWidth()
    )
}

如果使用了Scaffold组件，需要将imePadding()加在content对应的modifier上，同时不要覆盖Scaffold传入的innerPadding：

Scaffold(
    topBar = { /* 顶部导航栏 */ }
) { innerPadding ->
    Column(
        modifier = Modifier
            .fillMaxSize()
            .padding(innerPadding)
            .verticalScroll(rememberScrollState())
            .imePadding()
    ) {
        // 页面内容
    }
}

注意：如果页面无法滚动，即使加了imePadding，超出屏幕高度的输入框也可能无法正常显示，建议所有包含输入框的长页面都添加滚动属性

3. 如需更精细的控制软键盘间距，可通过WindowInsets监听软键盘高度，手动设置底部间距：

val imeBottom = WindowInsets.ime.getBottom(LocalDensity.current)
Column(
    modifier = Modifier
        .fillMaxSize()
        .padding(bottom = imeBottom.dp)
) {
    // 页面内容
}

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