Emoji 不显示或显示成方框乱码怎么办

场景一：社交 App 里还是旧 Emoji

这是正常现象，不是 bug——Instagram、TikTok、WhatsApp、Facebook、X 等主流社交平台都有自己内置的 Emoji 集，不走 Android 系统 Emoji 渲染路径。解决办法是做系统级模块刷入（07-系统级模块 组）。

场景二：系统界面 Emoji 变成方框 / 乱码

可能原因一：Emoji 包版本太新

Android 版本决定了系统支持的 Emoji 字符范围。如果你的 Android 版本太低，Emoji 包用的字符系统不认识，就会显示成方框。

解决办法：换一个适配你 Android 版本的 Emoji 包。zFont3 内置库会标注兼容性版本，选对了就不会出这个问题。

可能原因二：多个 Emoji 包冲突

如果你同时 Apply 了多个 Emoji 包或者系统级模块里刷了多个 Emoji 模块，会互相覆盖。

解决办法：

1. zFont3 → Settings → Reset Emoji
2. 系统级模块管理器（如果刷了）里只保留一个 Emoji 模块
3. 重新 Apply 一次

可能原因三：字重缺失

Emoji 虽然本质是字体文件，但它只有 Regular 一种字重。如果你创建字体模块时错误地把 Emoji 文件映射了多个字重，会导致渲染异常。

解决办法：Emoji 模块和字体模块分开创建，不要混在一起。

场景三：部分 Emoji 显示、部分不显示

这是字重映射不完整的典型表现——只有系统主要路径的 Emoji 换了，其他路径没覆盖。

• 系统级模块用户：检查模块里 Emoji 字体文件是不是完整覆盖了 NotoColorEmoji.ttf 和品牌定制的 Emoji 字体（Samsung 的 SamsungColorEmoji.ttf 等）
• 免 Root 用户：这种情况比较少见，大概率是文件接入没完全配置好，回头检查 Shizuku / SAF 状态

场景四：重启后 Emoji 消失了

• 电池优化问题：zFont3 和主题引擎被系统杀掉了，重新 Apply 一次
• OTA 系统更新覆盖：系统更新可能重置了 Emoji 路径，需要重新 Apply
• 系统级模块被禁用：模块管理器里检查一下是不是被关了