有个怪问题:深色模式下,折叠态配色正常,展开到内屏之后部分区域变成亮色了,像是漏了一块没跟随主题。
代码里颜色都是 $r('app.color.xxx'),不应该啊。
这类"局部不跟随主题"的问题,通常是下面四种原因,按概率排序:
① 硬编码颜色混在资源里
最常见的不是资源写错,而是某处直接写了十六进制:
// ❌ 展开态新加的组件里写了硬编码
Column() { /* ... */ }
.backgroundColor('#FFFFFF')
// ✅ 统一走资源
Column() { /* ... */ }
.backgroundColor($r('app.color.bg_primary'))
排查方法:全局搜 '# 和 Color.White / Color.Black,逐个替换。
② 深色资源目录缺失
resources/
├── base/element/color.json // 浅色
└── dark/element/color.json // 深色 ← 必须有,且 key 要一一对应
dark/color.json 里必须包含 base 中所有同名的 key,缺哪个,哪个就用浅色值。
③ 第三方组件/自绘 Canvas 不走主题
// Canvas 里的颜色是"画上去"的,不会跟随资源
Canvas(this.ctx)
.onReady(() => {
// ❌ 直接写死
this.ctx.fillStyle = '#FFFFFF'
// ✅ 从资源里取
const color = this.getUIContext().getHostContext()!.resourceManager
.getColorSync($r('app.color.canvas_bg').id)
this.ctx.fillStyle = `#${color.toString(16).padStart(6, '0')}`
})
并且在主题切换时要重绘:
onConfigurationUpdate(newConfig: Configuration) {
if (newConfig.colorMode !== this.lastColorMode) {
this.redrawCanvas()
}
}
④ 子窗口 / 弹窗没继承主题
用 window.createWindow 或自定义 dialog 时,新窗口默认是浅色,需要显式设置:
const win = await window.createWindow({ name: 'dialog', ctx: context })
await win.setWindowSystemBarProperties({ /* ... */ })
// 关键:设置窗口的颜色模式
await win.setWindowColorMode(window.ColorMode.COLOR_MODE_DARK)
或者弹窗内容自己读 AppStorage 里的 colorMode 来切换。
⑤ 一个排查技巧:把两个断点下的同一页面截图并排放在一起对比,异常区域会非常明显。大多数"展开态颜色不对"其实就是"展开态才出现的那几个组件"忘了适配——折叠态根本没有这块 UI。
先查展开态才出现的区域:即使用了 $r,同名资源在 dark/element/color.json 中缺失也可能回退到浅色值。
再看是否把 getColorSync 的结果缓存成普通变量,或 Canvas 只在首次绘制时取色。
主题变化后重新取色、重绘。可先把异常资源的深色值改成明显颜色,区分资源未命中还是绘制没更新。
"部分区域变亮色"这个症状,九成不是深色模式坏了,是那部分区域的颜色根本没用资源引用。排查按命中率排:
一、硬编码色值漏网:全项目搜十六进制字面量(#FFFFFF、#F1F3F5 这类)和 rgb() 写法——只要有一处背景色写死成亮色值,深色模式下就是"漏了一块"。$r('app.color.xxx') 都写了不代表全覆盖,第三方组件内部样式、Canvas 自绘、弹窗蒙层是最常见的漏网点。
二、资源限定目录没配全:dark 目录存在但只搬了部分资源,其他资源回退到 base(亮色)。逐个核对展开态用到的新组件——很多页面是适配折叠屏时新写的,写的时候没同步补 dark 资源。
三、expandSafeArea 的沉浸区:延伸进安全区的组件(标题栏、图片背景)如果自绘背景色,这个色值大概率是写死的——沉浸区是深色模式漏色重灾区。
四、展开态特有的可能性:组件按断点 if/else 双实例渲染时,展开态那个实例的样式可能没走主题变量(写的时候只对着折叠态调)。两个实例逐个核对颜色来源。
五、快速定位法:DevEco 开启深色模式预览,逐组件挂 Inspector 看颜色来源——是资源引用(显示了资源名)还是硬编码(直接是色值),一眼分流。
一句话收束:深色模式"漏一块"的本质是颜色来源不统一——全项目色值走资源引用加 dark 目录补全,硬编码清零后,展开态折叠态就都跟主题走了。

