正确：包裹汉字、放拼音是最小可行结构；但多音字、古音须人工核对，声调需用unicode字符（如zēng），不可用全角或“zeng1”；逐字注音更稳妥，需注意dom顺序、字体兼容与语义闭合。
ruby 标签加注音的基本结构是否正确
直接用 <ruby></ruby> 包裹汉字、再用 <rt></rt> 放拼音，是最小可行方案。但历史人物名字常含多音字、古音或异读，比如「曾国藩」的「曾」读 zēng 不是 céng，「贾谊」的「贾」读 jiǎ，这些必须人工指定，浏览器不会自动识别。
常见错误是把拼音写成全角字符或漏掉声调——<rt>Zeng</rt> 无效，应写 <rt>zēng</rt>；声调符号必须用 Unicode 字符（如 ā á ǎ à），不能用英文+数字（如 "zeng1"）。
示例：
<p>曾<ruby>曾<rt>zēng</rt></ruby>国藩</p>
遇到生僻字或古音时 ruby 还管用吗
<ruby></ruby> 本身不校验字音对错，只负责渲染位置。它能显示任何你填进去的 <rt></rt> 内容，哪怕写成 <rt>duān</rt>（「端」本读 duān，但若想标「瑞」的古音，也照显不误）。问题在于：屏幕阅读器和部分浏览器对 <ruby></ruby> 的语音支持有限，尤其古音、异读几乎不被朗读引擎识别。
如果目标是辅助阅读（比如学生查历史资料），建议额外加 aria-label 提供可读文本：
<p>贾<ruby>贾<rt>jiǎ</rt></ruby>谊<span class="visually-hidden" aria-label="贾谊，音 jiǎ yì"></span></p>
列表要点：
-
<ruby></ruby>不解决读音准确性，只解决视觉标注 - 古籍中「尉迟恭」的「尉」读
yù，不是wèi，必须手动核对并填写 - 部分字体（如某些 Windows 默认中文字体）对
<rt></rt>渲染高度控制差，可能压住正文，需用 CSS 微调ruby { line-height: 1.2; }
多个字连用时 rt 是逐字还是整体标注
历史人名通常逐字注音更稳妥。例如「司马懿」应拆为「司」「马」「懿」三组 <ruby></ruby>，而非整个词套一个 <rt></rt>。原因：「司」单独读 sī，但「司马」作为复姓，现代习惯仍读 sī mǎ，未发生变调；而「诸葛孔明」的「诸」在「诸葛」中实际轻读近 zhū 或 zhū（非 zhū），但教学场景下仍标本音更清晰。
不要这样写（错误）：
<ruby>司马懿<rt>sī mǎ yì</rt></ruby>
推荐这样（明确、可控）：
<ruby>司<rt>sī</rt></ruby><ruby>马<rt>mǎ</rt></ruby><ruby>懿<rt>yì</rt></ruby>
例外情况：当某字在特定人名中存在固定异读（如「万俟」读 mò qí），可将二字合为一个 <ruby></ruby> 单元，并在 <rt></rt> 中写 mò qí，避免被误断为「万」「俟」各自发音。
在真实网页中 ruby 注音容易被忽略的细节
最常被跳过的其实是语义闭合与样式兼容性。HTML 规范要求 <ruby></ruby> 必须包含至少一个 <rt></rt>，且 <rt></rt> 必须紧跟在对应基础文本后（不能隔标签）。下面这段代码在部分旧版 Safari 中会渲染异常：
<ruby>曾<span class="note">（曾氏）</span><rt>zēng</rt></ruby>
因为 <span></span> 插入在基础字和 <rt></rt> 之间，破坏了 DOM 结构预期。应改为：
<ruby>曾<rt>zēng</rt></ruby><span class="note">（曾氏）</span>
其他关键点：
- 移动端 Safari 对
<ruby></ruby>的行内换行支持不稳定，长人名建议用white-space: nowrap防止折断 - 如果页面用了 Web Font，确保该字体包含
<rt></rt>所需的拉丁字符（带声调），否则拼音可能 fallback 到系统字体，样式突兀 - 不要依赖
<rp></rp>标签做兼容降级——现代浏览器已无需它，且多数屏幕阅读器忽略<rp></rp>，反而增加冗余
历史人名注音这事，技术上简单，难点永远在音准判断和上下文一致性。比如「沈括」的「沈」作姓氏读 shěn，但《梦溪笔谈》里他自称「沈存中」，「存中」二字要不要注？这类决策不在 HTML 能力范围内，得靠编辑者定。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
