Rockbox 主题与字体不兼容 - 为什么主题加载失败或乱码

主题加载失败的三种常见原因

原因一：分辨率不匹配（最常见）

Rockbox 主题是按目标屏幕分辨率设计的——一个 640×480（iPod Classic）的主题不能直接用在 96×96（Sansa Clip Zip）上。主题里的位图资源、布局坐标都是按特定分辨率写的，换屏幕就错位或显示不全。

Rockbox 不会替你缩放主题——分辨率不对直接加载失败。

解决：

1. 去 themes.rockbox.org 先选你的设备 Target
2. 筛选出来的主题一定是该分辨率的
3. 不要跨 Target 下载主题

原因二：字体缺失

社区主题几乎都依赖特定字体文件——主题 zip 里会写 "Requires Rockbox Font Pack" 或指定某个字体（如 "12-NotoSans.fnt"）。如果你没装 Rockbox 字体包，主题要用到的 .fnt 文件不存在 → 加载失败或乱码。

典型表现：

• 主题能加载，但所有文字都是方块或问号（找不到对应字体）
• Rockbox 弹窗提示 "Missing font file xxx.fnt"

解决：

1. 下载 Rockbox Font Pack（字体包是独立 zip）
2. 解压到 DAP 根目录 → .rockbox/fonts/ 自动多出几十个 .fnt 文件
3. 重启 Rockbox 或重新加载主题

原因三：Rockbox 版本差异

Rockbox 4.0 和 3.x 之间有一些主题配置语法的小变化——某些老主题在新版本上可能加载失败。

Rockbox Utility 可以检查：在主题页里标注了 "Works with release 4.0" 的是确认兼容的。没标注的可能能用也可能不能用。

字体加载失败

和主题类似，字体文件也可能：

1. 版本不兼容——Rockbox 4.0 之前和之后的 .fnt 格式有细微变化，某些非常老的 .fnt 加载不了
2. 字符集不完整——选了一个只有英文字母的字体，切中文就显示方块
3. 编码问题——某些自制 .fnt 文件可能编码损坏

解决：

• 优先用 Rockbox 官方字体包里的字体（全部经过 4.0 兼容性测试）
• 字符集不全 → 换一个带 CJK 的字体（WenQuanYi Zen Hei、Noto Sans CJK、GNU Unifont）
• 自制字体有问题 → 重新生成或放弃

主题和字体的正确安装顺序

1. 先装 Rockbox 字体包 → 解压到 DAP 根目录 → .rockbox/fonts/ 下有字体
2. 再装主题 → 解压到 DAP 根目录 → .rockbox/themes/主题名/ 下有主题文件
3. 最后在 Rockbox 里切换 → Settings → Theme Settings → Load Theme → 选中

反顺序（先装主题后装字体） 也没问题，但切换主题时 Rockbox 可能报字体缺失，装好字体后重切一次就行。

主题显示正常但布局怪异

主题能加载但界面看起来不对劲（文字错位、按钮浮在不该在的位置）：

可能原因：

1. Rockbox 版本差异——主题是给 3.14 写的，你用的 4.0
2. 主题作者的设备有额外硬件（比如 S/PDIF 输出、额外按键），主题布局考虑了这些，你的设备没有 → 布局出现空洞或错位
3. 主题的 WPS / SBS 配置文件损坏

解决：

1. 换一个主题试试——Rockbox 有几百上千款，总有一款能正常用
2. 或自己编辑主题的 .cfg 文件（Rockbox WPS/SBS 配置是纯文本，可以手动调布局坐标）

Backdrop 和主题的冲突

如果你给 WPS 设了自定义 Backdrop（背景图），同时主题也自带 Backdrop——你设的那个优先。想换回主题自带的背景？在 WPS 的 Context Menu → Set Backdrop → Theme Default 就能切回去。

复古掌机的主题特殊性

RG35XX / TrimUI 这类复古掌机的 Rockbox 端口，屏幕分辨率虽然是 640×480 或更高，但 Rockbox 在这些设备上可能用的是不同于传统 DAP 的渲染模式——某些传统 DAP 主题在复古掌机上布局可能有细微差异。

解决：选主题时选同时标注 "Works with hosted mode" 或 "Works with RG35XX / TrimUI" 的。