Android Studio中XML布局下如何将状态栏颜色改为白色？

以下是几种可靠的解决方案，按场景选择使用：

一、通过主题样式全局设置（推荐） #

修改项目的主题配置，全局统一状态栏样式：

1. Material Components主题 #

打开res/values/styles.xml（如需适配深色模式，同步修改res/values-night/styles.xml），调整AppTheme：

<style name="AppTheme" parent="Theme.MaterialComponents.Light.NoActionBar">
    <!-- 设置状态栏背景为白色 -->
    <item name="android:statusBarColor">@android:color/white</item>
    <!-- 开启状态栏文字/图标深色模式（白色背景下必须设置，否则文字看不见） -->
    <item name="android:windowLightStatusBar">true</item>
</style>

2. AppCompat主题 #

如果项目使用AppCompat主题，注意属性兼容：

<style name="AppTheme" parent="Theme.AppCompat.Light.NoActionBar">
    <item name="colorPrimaryDark">@android:color/white</item>
    <!-- Android 6.0+ 适配深色状态栏文字 -->
    <item name="android:windowLightStatusBar">true</item>
    <item name="windowLightStatusBar">true</item>
</style>

二、单个Activity动态设置 #

如果只需在特定页面修改状态栏，在对应Activity的onCreate方法中添加代码：

Java版本 #

import android.os.Build;
import android.view.View;

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);
    
    // 设置状态栏背景色为白色
    getWindow().setStatusBarColor(getResources().getColor(android.R.color.white));
    // 适配Android 6.0+，设置状态栏文字为深色
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
        getWindow().getDecorView().setSystemUiVisibility(View.SYSTEM_UI_FLAG_LIGHT_STATUS_BAR);
    }
}

Kotlin版本 #

import android.os.Build
import android.view.View

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_main)
    
    window.statusBarColor = resources.getColor(android.R.color.white, theme)
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
        window.decorView.systemUiVisibility = View.SYSTEM_UI_FLAG_LIGHT_STATUS_BAR
    }
}

三、排查冲突问题 #

如果以上方法无效，检查以下几点：

• 确认布局文件中是否设置了fitsSystemWindows="true"，该属性可能干扰状态栏渲染，可尝试移除或调整。
• 排查是否有第三方沉浸式状态栏库覆盖了系统设置，暂时禁用相关库测试。
• 注意版本兼容：windowLightStatusBar仅在Android 6.0（API 23）及以上生效，低版本系统无法修改状态栏文字颜色，不建议设置白色状态栏（否则文字会和背景融合）。

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