多音字必须人工结合语境判断读音后,用一对一标注,不可依赖自动工具;如“重庆”标Chóngqìng、“银行”拆为yín+háng、“发奋”标fā、“发财”标fà,轻声、儿化须规范,导出前须人工核验。

多音字不能靠自动工具“猜”,必须人工结合语境判断读音后,再用 <ruby></ruby> 一对一标注——否则屏幕阅读器会读错,PDF 导出或打印时拼音还可能错位。
多音字必须人工定音,别信“自动识别”
像 pinyin-pro 或 pypinyin 这类库能输出多音候选(如“长”返回 ["cháng", "zhǎng"]),但它们不理解上下文。“长大”的“长”读 zhǎng,“长度”的“长”读 cháng,程序无法区分。强行让 JS 自动选一个,等于把语音错误写进 HTML 结构里。
- 标“重庆”必须写
<ruby>重庆<rt>Chóngqìng</rt></ruby>,不是Zhòngqìng - 标“银行”必须写
<ruby>银<rt>yín</rt><ruby>行<rt>háng</rt></ruby></ruby>,不是xíng - 遇到“发”字,先查原文:“发奋”标
fā,“发财”标fà,不能混用
<ruby></ruby> 结构必须拆到单字,且每个字配独立 <rt></rt>
浏览器只认“一对一”结构:<ruby></ruby> 容器内,每个汉字(或 <rb></rb>)必须紧接一个 <rt></rt>。写成 <ruby>银行<rt>yín háng</rt></ruby> 看似省事,实际在 Safari 和部分 WebView 中,拼音会整体偏左、压字,甚至被截断。
- 正确写法:
<ruby><rb>银</rb><rt>yín</rt></ruby><ruby><rb>行</rb><rt>háng</rt></ruby> -
<rb></rb>不可省略——Safari 16 及更早版本依赖它定位基线,否则ruby-align: center失效 - 轻声字(如“妈妈”的第二个“妈”)标为
ma,不加声调;儿化音(如“花儿”)标为huār,不是huā ér
办公场景下怎么批量处理又不出错?
WPS 的“拼音指南”或在线标音工具能快速生成初稿,但导出前必须人工过一遍多音字。尤其注意:合同、教材、公文这类正式文本,一个读音错误会影响法律效力或教学准确性。
立即学习“前端免费学习笔记(深入)”;
- 用正则辅助检查:
<ruby>[^[a-zāáǎàōóǒòēéěèīíǐìūúǔùüǖǘǚǜ]+</ruby>匹配基本结构,再人工核对音节是否对应字 - 避免在
<rt></rt>里混入全角空格、中文括号或大写字母——Safari 对这类字符极其敏感,易导致拼音横向错位 - 导出 PDF 前,用 Playwright 渲染预览:有些旧版
html-ppt-to-pdf工具会忽略<rp></rp>,导致拼音丢失,建议强制加<rp>(</rp><rt>...</rt><rp>)</rp>
最常被忽略的点是:多音字标注不是“加拼音”,而是“定读音 + 标结构”。一旦把错误读音塞进 <rt></rt>,后续所有自动化流程(语音朗读、无障碍访问、PDF 导出)都会继承这个错误,且难以批量修正。



















