多音字必须人工判断上下文，ruby不解析语义、不分词、不查词典；“长”标cháng或zhǎng取决于手动输入，“重”在“重要”读zhòng、“重来”读chóng，需按词切分并逐词确认读音。
多音字必须人工判断上下文，ruby 不会自动识别
浏览器对 ruby 的处理纯属呈现层，它不解析语义、不分词、不查词典。所谓“长”标成 cháng 还是 zhǎng，完全取决于你写进去的是哪个——工具不会帮你选。
常见错误是直接拿整段文字丢进拼音 API，结果“重”在“重要”里被标成 zhòng（正确），但在“重来”里也标成 zhòng（应为 chóng），因为 API 没读上下文。
实际标注时要按词切分，再逐词确认读音：
• “长大” → <ruby>长<rt>zhǎng</rt></ruby><ruby>大<rt>dà</rt></ruby>
• “长度” → <ruby>长<rt>cháng</rt></ruby><ruby>度<rt>dù</rt></ruby>
• “行”在“银行”中读 háng，在“行走”中读 xíng，不能混用
带声调拼音怎么输？优先用 Unicode 字符，别用数字标调
输入带声调的拼音，本质是输入 Unicode 字符，不是“加音调”。搜狗、微软拼音、Mac 系统自带输入法都支持软键盘 → 拼音字母 → 点击带调号的字母（如 ā、á、ǎ、à）。
关键点：
• 必须用半角小写字母 + Unicode 声调符号（如 zhōng），不是 zhong1
• 全角空格、中文标点、大写字母混入拼音会导致 rt 内容错位或换行
• ü 不能写成 u 或 v，得用输入法专门打出（如搜狗打 nv 出 nǚ）
• 轻声不加调号，如“妈妈”是 mā ma，第二个 ma 后面不能跟 ˙ 或数字
ruby 标注多字时，必须一字一 ruby，不能整句包一层
把整段话套一个 ruby 标签，比如 <ruby>你好世界<rt>nǐ hǎo shì jiè</rt></ruby>，会导致拼音堆在第一个字上方，其余汉字没拼音——这是最常踩的坑。
正确做法是每个汉字（或语义单位）单独包裹：
• 单字词：直接逐字标，如 <ruby>你<rt>nǐ</rt></ruby><ruby>好<rt>hǎo</rt></ruby>
• 多音节词：按词切分后标，如“中华人民共和国”建议拆为 <ruby>中华<rt>zhōng huá</rt></ruby><ruby>人民<rt>rén mín</rt></ruby><ruby>共和国<rt>gòng hé guó</rt></ruby>（注意此处“共和国”是固定词，不拆单字）
• 儿化音写成 huār，不是 huā ér；“一会儿”标为 yī huìr，中间不空格
旧浏览器 fallback 怎么做？rp 不是可选项，是必选项
IE9、部分安卓 4.x WebView、旧版 Opera Mini 无法识别 rt，会把它当普通文本渲染出来，导致页面出现裸露的拼音，破坏阅读流。
加 rp 是唯一可靠 fallback：
• 正确结构：<ruby>重<rp>(</rp><rt>chóng</rt><rp>)</rp></ruby>
• 现代浏览器隐藏 rp，只显示“重”字上方的 chóng
• 旧浏览器忽略 rt 和 rp 标签逻辑，直接渲染为“重(chóng)”
• 漏掉 rp 在老环境里就是“重chóng”，没有括号隔离，视觉混乱
立即学习“前端免费学习笔记（深入）”；
真正麻烦的从来不是怎么敲出 ā，而是判断“发”在“发展”里读 fā、在“理发”里读 fà、在“古法”里读 fǎ——这一步没法交给 HTML 或 CSS，得人盯着上下文一个字一个字过。
