Android Jetpack Compose中Scaffold自定义背景色设置不生效

你的颜色定义本身没有问题，AppColors.mOrangeOne是完全不透明的合法色值，不生效是Scaffold的布局层级和默认实现逻辑导致的：

• 给Scaffold的Modifier链式调用.background()完全无效：Scaffold内部的内容容器会占满整个可用空间，直接盖住最外层modifier设置的背景，这部分代码可以直接删掉。
• 仅传backgroundColor参数显示白色的核心原因：
  • 如果你用的是Material3版本的Compose组件，Scaffold会在content lambda的内容层默认套一个使用主题surface色（默认白色）的容器，直接覆盖了你在Scaffold上设置的背景色。
  • 如果你自己在Scaffold的content内部写了带默认白色背景的组件（比如未指定颜色的Surface、Card等），也会出现同样的覆盖问题。

正确写法 #

保留Scaffold的backgroundColor参数设置，在内容层将根容器的背景设为透明，露出Scaffold层的颜色即可，参考代码：

Scaffold(
    modifier = Modifier.fillMaxSize(),
    topBar = { TopBar() },
    floatingActionButton = { FAB() },
    backgroundColor = AppColors.mOrangeOne
) { innerPadding ->
    // 内容根容器，设置透明背景穿透显示Scaffold底色
    Box(
        modifier = Modifier
            .fillMaxSize()
            .padding(innerPadding)
            .background(Color.Transparent)
    ) {
        // 在此处编写页面其余内容
    }
}

如果按上述修改后仍显示白色，逐层检查Scaffold内部的子组件、Scaffold外层嵌套的父容器，是否存在未指定颜色、默认带白色背景的组件覆盖即可。

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