多音字必须人工判断语境后手动指定唯一读音，因ruby标签不识别语义、不支持条件渲染，rt内容会被语音软件直读为“fǒu slash pǐ”，且需与汉字严格一对一映射；正确做法是依语境选一音标注，并用data-pinyin存备选。
多音字必须人工判断语境后手动指定唯一读音，HTML 的 ruby 标签本身不识别语义、不支持条件渲染、也不接受斜杠分隔的多音写法（如 fǒu/pǐ）。
为什么不能用 rt 写“fǒu/pǐ”这种多音混排？
语音合成器和读屏软件会把 <rt>fǒu/pǐ</rt> 当作一个字符串朗读，结果是“fǒu slash pǐ”，不是切换读音。浏览器不解析拼音内部结构，rt 只接受纯文本内容，且必须与对应汉字严格一对一映射。
- 错误示例：
<ruby>否<rt></rt></ruby>—— 语义模糊，无障碍访问失败 - 正确做法：根据上下文选其一，比如“否极泰来”中固定标为
<ruby>否<rt>pǐ</rt></ruby> - 若需保留备选读音，用
data-pinyin属性额外存一份：<ruby data-pinyin="fǒu,pǐ">否<rt>pǐ</rt></ruby>，供 JS 后续处理或工具提取
常见多音字语境判断参考点
不能靠词库自动匹配，但可借助几个稳定线索缩小判断范围：
- “长”作形容词（长度、长远）读
cháng，作动词（生长、长大）读zhǎng；作姓氏时也读zhǎng - “行”在“银行”“行业”中读
háng，在“行走”“行动”中读xíng，作姓氏读Háng - “重”在“重要”“重复”中读
zhòng，在“重叠”“重新”中读chóng；地名“重庆”固定读Chóngqìng - “发”在“发现”“发展”中读
fā，在“理发”“结发”中读fà
注意：这些规则仍有例外（如“道行”读 dào héng），最终仍需结合具体词义和权威词典确认。
DeepBI DHTML 页面生成器
下载
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面，使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力： - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面； - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”； - 提及位于 `apps/console/src/featur
立即学习“前端免费学习笔记（深入）”；
如何让标注更可靠？配合 lang 和结构控制
仅靠 ruby 不足以支撑多音决策，但能提升输出一致性：
- 每个
ruby块只包一个字或一个不可分割的词（如“重庆”整体标Chóngqìng，不拆成“重+庆”） - 整句含多个多音字时，逐字检查并分别标注，避免跨字共用一个
rt - 外层容器加
lang="zh-CN"，确保语音引擎启用中文 TTS 引擎，而不是强行按英文切音节 - 避免在同一个
ruby中混入非汉字内容（如数字、英文字母），否则rt映射易错位
最麻烦的地方不在写法，而在于判断本身——没有通用规则能覆盖所有文言、方言、专有名词和历史用法。哪怕标对了“乐”在“快乐”里读 lè，遇到“音乐”还得切回 yuè。人工校对仍是不可绕过的环节。
