Compose中Scaffold因WindowCompat设置产生多余内边距问题求解

问题原因 #

当调用WindowCompat.setDecorFitsSystemWindows(window, false)开启边缘到边缘显示后，系统将状态栏、导航栏等系统栏的空间控制权交给应用。而Material3的Scaffold组件默认会监听系统窗口的Insets（系统栏占用的区域），自动将这些Insets转换为内容内边距——无论你是否设置了topBar或bottomBar。这是Scaffold的默认防护逻辑，原本是为了避免内容被系统栏遮挡，但在不需要系统栏偏移的场景下，就会产生多余的空白内边距。

解决方法 #

1. 直接清除Scaffold的默认Insets #

通过给Scaffold设置windowInsets = WindowInsets(0)，完全禁用其自动添加系统栏内边距的行为：

WindowCompat.setDecorFitsSystemWindows(window, false)

setContent {
    TestTheme {
        Box(
            modifier = Modifier
                .fillMaxSize()
                .background(Color.Cyan)
        ) {
            Scaffold(
                modifier = Modifier
                    .fillMaxSize(0.8f)
                    .align(Alignment.Center),
                windowInsets = WindowInsets(0) // 关键：清除默认Insets
            ) { _ ->
                Box(
                    modifier = Modifier
                        .fillMaxSize()
                        .background(Color.White)
                ) {
                    Text("Android")
                }
            }
        }
    }
}

2. 忽略Scaffold返回的PaddingValues #

如果不需要Scaffold自动生成的内边距，直接忽略它返回的paddingValues即可：

Scaffold(
    modifier = Modifier
        .fillMaxSize(0.8f)
        .align(Alignment.Center),
) { _ -> // 忽略默认padding值
    Box(
        modifier = Modifier
            .fillMaxSize()
            .background(Color.White)
    ) {
        Text("Android")
    }
}

3. 按需控制Insets行为 #

如果需要在设置topBar/bottomBar时才应用对应内边距，可以手动判断并配置windowInsets：

val needTopBar = true // 根据实际业务需求切换状态
val targetInsets = if (needTopBar) WindowInsets.systemBars else WindowInsets(0)

Scaffold(
    modifier = Modifier
        .fillMaxSize(0.8f)
        .align(Alignment.Center),
    topBar = if (needTopBar) { /* 你的TopBar实现代码 */ } else null,
    windowInsets = targetInsets
) { paddingValues ->
    Box(
        modifier = Modifier
            .padding(paddingValues)
            .fillMaxSize()
            .background(Color.White)
    ) {
        Text("Android")
    }
}

内容的提问来源于stack exchange，提问作者X-Black...