EPUB中ruby标签无法保证正常渲染，因阅读器支持差异极大；必须字级独立闭合、禁用rb/rp标签，CSS控制极有限，目标含Kindle时应降级为括号注音或图片。
ruby标签在EPUB中是否能正常渲染
不能默认保证，EPUB阅读器对ruby的支持差异极大——Calibre、Apple Books 和某些安卓阅读器（如 Moon+）能解析并排版，但 Kindle（含 KFX）、旧版 Adobe Digital Editions 和多数微信读书内嵌 WebView 完全忽略 rt，只显示裸汉字，甚至把拼音当乱码吞掉。
常见错误现象：<ruby>饕<rt>tāo</rt></ruby> 在 Apple Books 里显示为“饕”上方带小字“tāo”，但在 Kindle App 里只剩“饕”，拼音彻底消失；更糟的是，部分阅读器会把 rt 当作非法标签直接丢弃 DOM 节点，导致后续文本错位。
关键判断：如果你的电子书目标平台包含 Kindle 或需导出为 MOBI，ruby 就不是可用方案，必须降级为纯文本括号或图片注音。
EPUB 中 ruby 的结构写法必须严格到字级
EPUB 渲染引擎（尤其是基于 WebKit 的）对嵌套容忍度极低，任何“偷懒”结构都会被截断或错位：
立即学习“前端免费学习笔记（深入）”；
-
<ruby>北京<rt>běi jīng</rt></ruby>→ 多数阅读器不识别，拼音压成一团或不显示 -
<ruby>北<rt>běi</rt></ruby><ruby>京<rt>jīng</rt></ruby>→ 唯一稳定写法，每个字独立闭环 - 禁用
rb标签：虽然语义更准，但 Calibre 2.90+ 之前版本会把rb当作未知标签移除，导致rt失去锚点 -
rp不仅无用，反而有害：EPUB 打包工具（如 Sigil）常把rp内容当作冗余剔除，或触发校验失败
CSS 在 EPUB 中几乎无法控制 ruby 排版
EPUB 的 CSS 支持受限于阅读器内核，ruby-相关样式大多被无视：
-
ruby { display: ruby; }→ Apple Books 认，但 Moon+ 直接忽略，且 MOBI 不支持该值 -
rt { font-size: 0.6em; line-height: 1; }→ 仅 Apple Books 生效；Kindle 完全按默认字号渲染，且不响应line-height -
ruby-position和ruby-align→ 全部阅读器都不支持，设了等于没设 - 唯一可靠操作：
rt { color: #888; }（部分阅读器认颜色），其他样式建议放弃
真实场景中，你写的 CSS 更可能影响基字（汉字）本身，而非 rt —— 所以别指望靠样式“修好”错位问题。
替代方案比硬扛 ruby 更实际
面对 EPUB 的碎片化支持，强行统一用 ruby 只会增加维护成本和兼容风险。更可行的路径是分层处理：
- 源内容保留标准
<ruby>汉<rt>hàn</rt></ruby>结构，供 Apple Books 等支持者使用 - 构建时用脚本自动降级：将每个
ruby替换为<span class="pinyin">汉（hàn）</span>，括号 + 半角空格格式，所有阅读器都可读 - 对生僻字（如“龘”“靐”）单独生成 PNG 注音图，嵌入
<img>，绕过 HTML 解析限制 - 禁用 JavaScript 动态注入：EPUB 不执行 JS，
document.createElement('ruby')永远不会生效
最易被忽略的一点：EPUB 的 content.opf 文件里必须声明 prefix="rendition: http://www.idpf.org/vocab/rendition/#" 并启用 rendition:layout-reflowable，否则即使结构正确，某些阅读器也会强制关闭 ruby 渲染引擎。
