Android Jetpack Compose如何获取状态栏高度？现有方案失效求助

先排查基础配置问题 #

首先必须确保在Activity的onCreate方法中设置以下代码，这是Compose正确处理系统栏Insets的核心前提：

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    WindowCompat.setDecorFitsSystemWindows(window, false)
    setContent {
        // 你的Compose内容
    }
}

如果未开启该设置，系统会自动将布局填充到状态栏下方，导致WindowInsets返回数值为0，statusBarsPadding()也会失效。

正确获取状态栏高度的方法 #

方法1：通过WindowInsetsCompat手动收集状态栏Insets

这种方法能获取当前实际显示的状态栏高度，适配各种系统栏状态（比如沉浸式、全屏）：

@Composable
fun StatusBarHeightDemo() {
    val statusBarHeight = remember { mutableStateOf(0) }
    val context = LocalContext.current
    
    LaunchedEffect(Unit) {
        val window = (context as Activity).window
        val insets = WindowInsetsCompat.toWindowInsetsCompat(window.decorView.rootWindowInsets)
            .getInsets(WindowInsetsCompat.Type.statusBars())
        statusBarHeight.value = insets.top
    }

    Text(text = "当前状态栏高度：${statusBarHeight.value}px")
}

注意要在LaunchedEffect中执行获取逻辑，避免在Compose初始布局阶段还未计算出Insets时就获取值。

方法2：通过系统资源获取默认状态栏高度

这是一种 fallback 方案，获取的是系统定义的默认状态栏高度，不适用于状态栏隐藏或高度变化的场景，但在某些简单场景下可用：

@Composable
fun DefaultStatusBarHeight() {
    val resources = LocalContext.current.resources
    val defaultHeight = remember {
        val resId = resources.getIdentifier("status_bar_height", "dimen", "android")
        if (resId > 0) resources.getDimensionPixelSize(resId) else 0
    }
    Text(text = "默认状态栏高度：$defaultHeight px")
}

修复Modifier.statusBarsPadding()失效的问题 #

如果这个Modifier没效果，大概率是父布局的约束或Insets传递问题，试试以下正确用法：

@Composable
fun ScaffoldWithStatusBarPadding() {
    Scaffold(
        modifier = Modifier
            .statusBarsPadding()
            .consumeWindowInsets(WindowInsets.systemBars) // 确保Insets被正确消费
    ) { innerPadding ->
        Column(
            modifier = Modifier
                .padding(innerPadding)
                .fillMaxSize()
        ) {
            // 你的内容会自动避开状态栏区域
        }
    }
}

如果不用Scaffold，直接在根布局使用的话，要确保布局能正确响应Insets：

@Composable
fun RootLayoutWithStatusBarPadding() {
    Box(
        modifier = Modifier
            .fillMaxSize()
            .statusBarsPadding()
    ) {
        // 子布局会自动从状态栏下方开始绘制
    }
}

注意事项 #

• 全屏模式或沉浸式状态栏下，状态栏会被隐藏，此时获取到的高度会是0，使用前可以先判断状态栏的可见性。
• 不要在Composable的初始化代码块中直接获取Insets，必须借助LaunchedEffect、DisposableEffect等生命周期函数来延迟获取。

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