求助：Jetpack Compose M3 ModalBottomSheet聚焦TextField时与键盘间出现幽灵边距

问题原因 #

Jetpack Compose M3的ModalBottomSheet默认窗口Insets（插入区域）处理逻辑和M2不同，且你将ModalBottomSheet放在Scaffold外部时，未正确处理键盘（IME）弹出时的Insets，导致Sheet无法随键盘上移，出现冗余边距。

解决方案 #

1. 配置Activity软键盘模式

在AndroidManifest.xml中给对应Activity设置软键盘模式为adjustResize，让系统自动调整窗口大小适配键盘：

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

2. 调整ModalBottomSheet的Insets处理

显式让ModalBottomSheet感知键盘和导航栏Insets，并给内容添加键盘适配的padding：

var showSheet by remember { mutableStateOf(false) }
var text by remember { mutableStateOf("") }

if (showSheet) {
    ModalBottomSheet(
        onDismissRequest = { showSheet = false },
        // 让Sheet响应键盘和导航栏的Insets变化
        windowInsets = WindowInsets.ime + WindowInsets.navigationBars
    ) {
        Column(
            modifier = Modifier
                .fillMaxWidth()
                // 快捷添加键盘Insets的padding，确保内容随键盘上移
                .imePadding()
                .padding(16.dp)
        ) {
            TextField(
                value = text,
                onValueChange = { text = it },
                label = { Text("输入内容") }
            )
            // 其他Sheet内容
        }
    }
}

Scaffold(topBar = { /* 顶部栏 */ }) { paddingValues ->
    Column(modifier = Modifier.padding(paddingValues)) {
        Button(onClick = { showSheet = true }) {
            Text("打开底部弹窗")
        }
        // 主界面内容
    }
}

3. 额外优化点

• 若使用rememberModalBottomSheetState，建议设置skipPartiallyExpanded = true，避免部分展开状态干扰键盘适配：

  val sheetState = rememberModalBottomSheetState(skipPartiallyExpanded = true)
  

• 确保使用M3主题（如Theme.Material3.Light），避免主题样式冲突导致Insets处理异常。

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