Android 14+ 如何防止全屏布局与状态栏重叠

阿华AIGC实验室

2026-4-7

嘿，我之前升级到API 35的时候也踩过这个坑！Android 14对系统栏的默认布局行为做了调整，导致App默认会全屏延伸，内容跑到状态栏下面。别担心，下面这几个方法都能帮你快速恢复旧的布局逻辑——让内容老老实实从状态栏下方开始显示：

方法一：全局修改App主题（最推荐，一次设置全App生效）

这是最省心的方式，直接在主题配置里恢复旧版本的默认行为：

打开你的主题配置文件，一般是res/values/styles.xml或者res/values/themes.xml
找到你App的基础主题（通常继承自Theme.MaterialComponents.DayNight.NoActionBar或类似）
添加或修改以下关键属性：

<resources>
    <style name="AppTheme" parent="Theme.MaterialComponents.DayNight.NoActionBar">
        <!-- 核心设置：让系统自动处理布局与系统栏的间距，恢复旧行为 -->
        <item name="android:windowDecorFitsSystemWindows">true</item>
        <!-- 可选：设置状态栏颜色，和你的App风格匹配 -->
        <item name="android:statusBarColor">@color/your_status_bar_color</item>
        <!-- 可选：禁止布局延伸到刘海屏区域（如果你的App不需要适配刘海全屏） -->
        <item name="android:windowLayoutInDisplayCutoutMode">shortEdges</item>
    </style>
</resources>

这里的android:windowDecorFitsSystemWindows="true"是关键——它会告诉系统自动给布局顶部添加与状态栏高度一致的padding，确保你的内容不会被状态栏遮挡，这也是Android 14之前的默认行为。

方法二：单个Activity单独设置（适合只调整特定页面）

如果只需要某几个Activity恢复旧布局，不用改全局主题，可以在Activity的onCreate方法里动态设置：

Kotlin代码：

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    // 开启系统自动适配布局与系统栏
    window.setDecorFitsSystemWindows(true)
    // 可选：自定义状态栏颜色
    window.statusBarColor = ContextCompat.getColor(this, R.color.your_status_bar_color)
    setContentView(R.layout.activity_main)
}

Java代码：

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    getWindow().setDecorFitsSystemWindows(true);
    getWindow().setStatusBarColor(ContextCompat.getColor(this, R.color.your_status_bar_color));
    setContentView(R.layout.activity_main);
}

方法三：给布局根View添加属性（单个页面布局级调整）

如果只是某个页面的布局出问题，也可以直接在布局文件的根View上添加属性：

<!-- 比如你的根布局是LinearLayout -->
<LinearLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    <!-- 开启这个属性，让根View自动适配系统栏insets -->
    android:fitsSystemWindows="true"
    android:orientation="vertical">

    <!-- 你的所有子布局内容都会自动避开状态栏 -->
    <TextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="内容不会被状态栏挡住啦！"/>

</LinearLayout>

这个属性会让根View自动计算状态栏的高度，并给自己添加顶部padding，确保内部内容不会被覆盖。

如果你用Jetpack Compose的话

Compose里也有对应的解决方案，只需要给根布局添加systemBarsPadding()修饰符：

setContent {
    YourAppTheme {
        // 给根Box添加systemBarsPadding，内容就会自动避开状态栏和导航栏
        Box(modifier = Modifier.systemBarsPadding()) {
            // 你的Compose内容
            Text(text = "Compose内容也乖乖待在状态栏下面啦！")
        }
    }
}