Jetpack Compose中enableEdgeToEdge配WindowInsets(0.dp)状态栏padding闪烁求解

1. 提前获取系统窗口Insets，避免首帧计算延迟 #

首帧渲染时Compose往往还没拿到正确的系统栏Insets，直接用默认值布局会导致后续Insets更新时UI偏移抖动。可以在Activity启动阶段提前获取Insets，再传递给Compose布局：

// Activity的onCreate方法中
override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    WindowCompat.setDecorFitsSystemWindows(window, false)
    
    setContent {
        val systemInsets = remember { mutableStateOf(WindowInsetsCompat.Type.systemBars()) }
        
        // 启动时异步获取真实Insets
        LaunchedEffect(Unit) {
            val actualInsets = WindowInsetsCompat.toWindowInsetsCompat(
                window.decorView.rootWindowInsets,
                window.decorView
            ).getInsets(WindowInsetsCompat.Type.systemBars())
            systemInsets.value = actualInsets
        }

        YourAppTheme {
            Scaffold(
                topBar = {
                    TopAppBar(
                        title = { Text("首页") },
                        // 直接用提前获取的Insets设置内边距
                        modifier = Modifier.windowInsetsPadding(systemInsets.value)
                    )
                }
            ) { innerPadding ->
                // 主内容结合Scaffold的innerPadding和系统Insets
                Box(modifier = Modifier.padding(innerPadding)) {
                    // 你的页面内容
                }
            }
        }
    }
}

2. 启用Insets动画平滑过渡 #

系统栏Insets变化时（比如状态栏颜色切换、输入法弹出），默认的突变会导致抖动。启用Insets动画让布局平滑过渡：

// Activity中开启Insets动画支持
val insetsController = WindowCompat.getInsetsController(window, window.decorView)
insetsController.setSystemBarsBehavior(
    WindowInsetsControllerCompat.BEHAVIOR_SHOW_TRANSIENT_BARS_BY_SWIPE
)
// 或者在Compose中使用动画Insets
val animatedInsets = animateWindowInsetsAsState(
    windowInsets = WindowInsets.systemBars,
    animationSpec = tween(durationMillis = 150)
)
// TopAppBar使用animatedInsets
TopAppBar(
    title = { Text("首页") },
    modifier = Modifier.windowInsetsPadding(animatedInsets.value)
)

3. 提前配置主题避免首帧主题冲突 #

在XML主题里提前设置透明状态栏/导航栏，不要在Compose中动态修改，避免首帧因主题未生效导致布局错误：

<!-- res/values/styles.xml -->
<style name="AppTheme" parent="Theme.Material3.DayNight.NoActionBar">
    <item name="android:statusBarColor">@android:color/transparent</item>
    <item name="android:navigationBarColor">@android:color/transparent</item>
    <item name="android:windowLightStatusBar">true</item> <!-- 适配浅色状态栏文字 -->
</style>

4. 用rememberSaveable保存Insets状态 #

屏幕旋转等配置变更时，重新计算Insets会导致重复抖动，用rememberSaveable保存Insets值，避免重复计算：

val systemInsets = rememberSaveable { mutableStateOf(WindowInsetsCompat.Type.systemBars()) }

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