Jetpack Compose中LazyColumn内TextField被键盘遮挡如何处理

第一步：开启系统层面的软输入尺寸适配 #

• 在承载该Compose页面的Activity的onCreate方法中，给Window设置软输入调整模式：
  window.setSoftInputMode(WindowManager.LayoutParams.SOFT_INPUT_ADJUST_RESIZE)
• 如果项目开启了EdgeToEdge沉浸式布局，这个设置不能省略——否则系统不会自动压缩应用窗口的有效显示区域，所有Compose层的滚动适配都会失效。

第二步：给LazyColumn搭配官方内置的滚动适配 #

• 从Jetpack Compose 1.2版本开始，官方提供了Modifier.imeNestedScroll()修饰符，直接给承载TextField的LazyColumn加上即可。这个修饰符会自动匹配系统软输入的弹出/收起动画，触发LazyColumn的自然滚动逻辑，不需要手动计算键盘高度、自定义位移动画，交互体验和系统原生完全对齐。
• 注意别和Modifier.imePadding()混用：这个修饰符是给非滚动布局（比如固定的登录表单）加底部避让用的，套在LazyColumn上会和imeNestedScroll的逻辑冲突，出现滚动位置卡死、底部留大块空白的问题，两类场景二选一即可。

第三步：补充焦点触发的自动对齐优化 #

仅靠imeNestedScroll还会遇到边界问题：当点击列表最底部的TextField时，键盘弹出后该输入框可能只露在可视区边缘，出现被挡一半的情况。可以加一层轻量逻辑优化：

• 给LazyColumn维护一个固定的rememberLazyListState，给列表里每个TextField对应的item设置稳定的key
• 在TextField的焦点变化回调里，检测到获得焦点时，通过协程调用animateScrollToItem把当前输入框平滑滚动到可视区域偏上的位置，完全避开键盘遮挡范围，参考代码片段：

val listState = rememberLazyListState()
val coroutineScope = rememberCoroutineScope()

LazyColumn(
    state = listState,
    modifier = Modifier.imeNestedScroll()
) {
    itemsIndexed(fieldList, key = { index, _ -> "field_$index" }) { index, fieldContent ->
        OutlineTextField(
            value = fieldContent,
            onValueChange = { /* 更新列表对应位置的内容 */ },
            modifier = Modifier.onFocusChanged {
                if (it.isFocused) {
                    coroutineScope.launch {
                        // 滚动到对应item，留出足够的可视空间
                        listState.animateScrollToItem(index = index)
                    }
                }
            }
        )
    }
}

实际开发容易踩的坑

• 别照搬早年的旧方案：手动监听WindowInsets读取键盘高度、给LazyColumn加底部padding避让的写法，会把整个列表硬往上顶，滚到列表顶部时会留下大块无内容空白，动画和系统节奏对不上，还经常出现位置跳变。
• 排查Manifest配置：如果给对应Activity设了windowSoftInputMode="adjustNothing"，无论Compose层加多少适配修饰符都不会生效，系统会直接忽略软输入的尺寸调整。

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