CoordinatorLayout与Toolbar布局问题：图片需显示在状态栏后方

嘿，我之前也踩过这个坑！想用CoordinatorLayout实现图片延伸到状态栏后面的效果，思路是对的，但fitsSystemWindows这个属性经常会搞出一些意料之外的异常，尤其是当父View和子View的配置冲突时。

先理清楚核心问题 #

你提到原本的代码能实现效果但有异常，大概率是android:fitsSystemWindows="true"的作用范围没搞对。CoordinatorLayout的这个属性会让它自己预留出状态栏/导航栏的空间，但如果我们想让图片“钻”到状态栏后面，就得调整这个属性的使用逻辑，让目标View（比如ImageView）来处理系统窗口的inset。

给你一套可行的解决方案 #

1. 调整布局结构（重点）

去掉CoordinatorLayout本身的fitsSystemWindows="true"，转而给需要延伸到状态栏的ImageView设置这个属性，同时确保状态栏是透明的。示例代码如下：

<androidx.coordinatorlayout.widget.CoordinatorLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <!-- 要放在状态栏后方的图片 -->
    <ImageView
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:src="@drawable/your_target_image"
        android:scaleType="centerCrop"
        android:fitsSystemWindows="true"/>

    <!-- 其他需要叠在图片上方的控件（比如Toolbar） -->
    <com.google.android.material.appbar.AppBarLayout
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:fitsSystemWindows="true"
        android:theme="@style/ThemeOverlay.AppCompat.Dark.ActionBar">

        <androidx.appcompat.widget.Toolbar
            android:layout_width="match_parent"
            android:layout_height="?attr/actionBarSize"
            app:layout_scrollFlags="scroll|enterAlways"/>
    </com.google.android.material.appbar.AppBarLayout>

</androidx.coordinatorlayout.widget.CoordinatorLayout>

2. 配置透明状态栏主题

在styles.xml里给对应的Activity添加透明状态栏的主题，否则图片就算延伸过去也会被状态栏的底色挡住：

<style name="AppTheme.TransparentStatusBar" parent="Theme.MaterialComponents.Light.NoActionBar">
    <!-- 基础透明状态栏设置 -->
    <item name="android:statusBarColor">@android:color/transparent</item>
    <item name="android:windowTranslucentStatus">true</item>
    <!-- Android 10+ 适配：允许内容延伸到刘海/状态栏区域 -->
    <item name="android:windowLayoutInDisplayCutoutMode">shortEdges</item>
</style>

记得在AndroidManifest.xml里给目标Activity指定这个主题。

3. 排查异常的关键

如果之前的代码出现布局偏移、控件被莫名遮挡的异常，大概率是多个父/子View重复设置了fitsSystemWindows="true"，导致重复添加了padding。这时候只需要给真正需要的View（比如ImageView和AppBarLayout）设置这个属性，CoordinatorLayout本身保持默认即可。

另外，如果你还在用旧的android.support库，建议换成AndroidX依赖——support库已经被废弃，很多CoordinatorLayout的兼容性bug在AndroidX里已经修复了。

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