如何阻止键盘弹出时Scaffold的TopAppBar移出屏幕？

核心原因 #

Compose的窗口适配逻辑和传统View系统不同，默认情况下若未正确处理窗口Insets（状态栏、键盘等），加上错误的windowSoftInputMode配置，会导致整个布局被键盘顶起或平移，进而让TopAppBar移出屏幕。

有效解决方案 #

方案1：正确配置Insets + adjustResize模式

这是最推荐的方式，既保留Scaffold的结构，又能固定TopAppBar：

1. 修改AndroidManifest.xml：
   给对应Activity设置adjustResize模式，让窗口根据键盘大小重新计算布局：

   <activity
       android:name=".MainActivity"
       android:windowSoftInputMode="adjustResize">
       <!-- 其他配置内容 -->
   </activity>
   

2. 在Compose中处理Insets：
   通过windowInsetsPadding固定TopAppBar在状态栏下方，给内容区域添加键盘适配内边距：

   setContent {
       MyTheme {
           val windowInsetsController = rememberWindowInsetsController()
           // 可选：让状态栏图标适配主题明暗
           SideEffect {
               windowInsetsController.isAppearanceLightStatusBars = !isSystemInDarkTheme()
           }
   
           Scaffold(
               topBar = {
                   MyTopAppBar()
                       .windowInsetsPadding(WindowInsets.statusBars) // 固定TopAppBar位置
               },
               content = { innerPadding ->
                   ScaffoldContent(innerPadding)
                       .imePadding() // 内容自动适配键盘高度
                       .padding(innerPadding)
               }
           )
       }
   }
   

方案2：用固定权重布局替代Scaffold

如果方案1无效，可直接用Column+权重强制固定TopAppBar：

setContent {
    MyTheme {
        Column(modifier = Modifier.fillMaxSize()) {
            // TopAppBar固定在顶部，不参与内容滚动/压缩
            MyTopAppBar()
                .windowInsetsPadding(WindowInsets.statusBars)
            
            // 内容区域占满剩余空间，适配键盘
            Box(
                modifier = Modifier
                    .weight(1f)
                    .imePadding()
            ) {
                ScaffoldContent()
            }
        }
    }
}

同样需要确保AndroidManifest.xml中设置了adjustResize。

为什么之前的尝试无效？ #

• adjustPan模式会直接平移整个窗口，必然导致TopAppBar移出屏幕，不适合你的需求；
• 单纯替换为Column但未设置权重和Insets，布局仍会被整体顶起，无法固定TopAppBar；
• Compose不会自动处理Insets，必须显式配置才能让组件正确响应窗口变化。

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