多音字拼音标注出错的根本原因是HTML结构不满足ruby语义要求:必须用rb包裹汉字、rt标注拼音,且rt内须为半角小写+Unicode声调;缺失rb或rt、混用全角/数字标调均导致注音失效。

多音字拼音标注出错,根本原因不是“标错了读音”,而是 HTML 结构不满足 ruby 的语义要求——浏览器压根没把你的拼音当注音解析,更别提读对了。
ruby 标签里漏了 rt,拼音就等于没写
常见错误是写成 <ruby>否</ruby> 或者把拼音塞进 ruby 里当文本,比如 <ruby>否fǒu/pǐ</ruby>。这两种写法在任何现代浏览器中都不会触发注音渲染,屏幕阅读器也读不到,语音合成器更不可能选对音。
-
rt是必需子元素,不是可选装饰;没有它,ruby就是普通容器 - 多音字必须拆开单字标注:
<ruby>否<rt>pǐ</rt></ruby>,不能合并在一个rt里写多个音 - 若需提示其他读音(如“否”也读 fǒu),用
data-pinyin="fǒu"等属性备用,别塞进rt
没加 rb 包裹汉字,ruby-align 全失效
Safari 和旧版 Edge 中,<ruby>否<rt>pǐ</rt></ruby> 这种写法会导致拼音左贴、右飘甚至垂直偏移——因为浏览器找不到基字的锚点。原因在于:只有 rb 明确声明“这是被注字”,rt 才能被正确对齐。
- 每个汉字都必须包一层
rb,哪怕单字也不省略:<ruby><rb>否</rb><rt>pǐ</rt></ruby> - 多字词如“否极泰来”,要逐字拆:
<ruby><rb>否</rb><rt>pǐ</rt><rb>极</rb><rt>jí</rt><rb>泰</rb><rt>tài</rt><rb>来</rb><rt>lái</rt></ruby> - CSS 中必须显式设
ruby { ruby-align: center; },Safari 16 及更早版本不认默认值
拼音用了全角字符或数字标调,排版直接错位
Safari 对 rt 内容最敏感:一个全角空格、中文括号、大写字母或 zhong1 这类数字标调,都会导致拼音挤出汉字范围,甚至整段 rt 被截断或忽略。
立即学习“前端免费学习笔记(深入)”;
- 拼音必须用半角小写字母 + Unicode 声调(如
zhōng),禁用zhong1、Zhong、zhōng( - 不要在
rt里加空格、换行、缩进;写完立刻检查是否纯 ASCII 字符流 - 如果项目要兼容 Android 4.x 或 IE,必须加
rp成对包裹:<rp>(</rp><rt>pǐ</rt><rp>)</rp>,否则老浏览器只显示“否”,拼音彻底消失
真正难的不是选对读音,而是让浏览器“看见”并“理解”你写的那个音——结构松动一环,整个注音链就断了。尤其要注意 rb 和 rt 的配对强制性,以及 Safari 对纯 ASCII 拼音的苛刻要求,这两点最容易被忽略。



















