你有没有遇到过：手机切换到暗色模式后程序 UI、状态栏都随之变暗，但 App 内的卡片、列表、页面颜色却依旧亮亮的？这不是 bug，而是主题方案与程序资源联动不到位导致的 gap。

一、问题概述：暗色模式下 App 内容区不跟随

在 Demo 项目 MyApplication 中。我使用了自定义主题程序 ThemeState 来管理亮/暗两套颜色，并尝试让 App 通过 ConfigurationConstant.ColorMode.COLOR_MODE_NOT_SET 跟随程序。再看但实际运行时，

• 手机设置 → 深色模式
• 程序状态栏、程序级 UI 变暗 ✔︎
• App 内卡片、聊天页、列表颜色未变化 ✘

经过排查。我发现根本原因是我的主题方案没有和程序挂钩。

1️⃣ 使用者痛点回顾

• "为什么我的 App 颜色不会跟着程序暗色切换？"
• "我已经设置了跟随程序，却还是看到亮面"
• "想要全局统一暗色。却手动维护太繁琐"

二、资源程序基础：$r 与 $rawfile 的区别

$r 和 $rawfile 都是访问资源的方法，但机制完全不同。

$rawfile 的另一个细节是它会按当前模块寻找资源，所以同一张图片在不同模块可能找不到。

1️⃣ 使用者痛点重现：为什么图片无法跟随暗色？🔍 解决思路提示：

- 如果你使用的是 $rawfile 并想让图片跟随暗色，只能手动判断方法并切换；更简洁的方法是将图片放到 media 目录，用 $r 自动切换。

三、resources 限定符目录结构不足导致缺失 dark 目录

A Demo 的 resources 结构如下：

/├── base/ ← 默认兜底
│ ├── element/ ← color.json / string.json / float.json
│ ├── media/ ← 图片图标
│ └── profile/ ← 页面配置
├── zh_CN/ ← 中文字符串
└── en_US/ ← 英文字符串
/
// 注意：没有 dark/ 子目录！这就是缺失 dark 专属资源的一大隐患。

限定符匹配优先级大致为：

language。横竖屏,深浅色,分辨率,设备

因为缺少 dark 子目录，程序在遇到深浅色环境时无法找到对应资源，于是退回 base 子目录。于是文字会随语言变化而变化，但颜色始终保持亮色。

使用者痛点再现：为何仅语言能变而颜色不变？

• "我刚刚配置了 zh_CN 与 en_US 后文字就能翻了却仍然看不到暗色效果"
• "为什么只有文字能响应，而背景与卡片仍然保持亮白？"

四、正式实现 Dark Mode：resources/dark 必须存在且配对 color.json 文件

a) 在 base 子目录中提供默认color.json：

// resources/base/element/color.json {
"color":
}

b) 在 dark 子目录中提供相同名称但不同值的 color.json：

// resources/dark/element/color.json {
“color”​ :
}

$r 即可在明暗之间自动选择，无需手动判断 isDark 状态。但如果你把所有颜色硬编码为字符串，就会失去这种优势。例如：