多音字需按上下文人工确定唯一读音后标注,ruby仅支持“字→完整拼音”映射,不支持声母韵母拆分或语义推理;错误示例包括斜杠分隔多音、拆分拼音、忽略轻声儿化变调等。

多音字不能靠ruby自动拆解声母韵母——它只负责“字→拼音”的映射,不处理语音学分析。你得先人工判断读音,再手动标注。
多音字必须按上下文选唯一读音再标注
浏览器和屏幕阅读器不会识别“这个‘长’是长度还是长大”,ruby结构本身不带语义推理能力。常见错误是写成长,这会让语音引擎卡住或朗读混乱。
- 正确做法:根据句子确定读音,只标一种。例如“班长”中必须标
长,“长度”中则标长 - 若需保留多音提示,用
data-pinyin属性补充:长,供 JS 或 CSS 后续展开 - 避免在
里塞斜杠、顿号、括号等分隔符——它们不是合法拼音字符,会破坏可访问性
声母/韵母级拆分不是ruby的职责
ruby标准结构只支持“基字↔完整拼音”一对一映射,不支持把“hǎo”进一步拆成“h + ǎo”。强行拆分会破坏语义和渲染逻辑,比如写成好会导致两个都堆在“好”上方,视觉错乱且无法被读屏软件理解。
- 如确需教学级声母韵母展示(如识字课),应改用
包裹并配合 CSS 定位,例如:hǎo - 拼音库(如
pinyin-pro)可输出声母/韵母字段,但输出后必须脱离ruby结构单独渲染 - 注意:Unicode 声调符号(如
ǎ)属于韵母整体一部分,不能切开;数字标调(hao3)更不适合做视觉拆分
轻声、儿化、变调必须标实际读音,不是本音
拼音标注目标是“人怎么读”,不是“字典怎么列”。例如“妈妈”的第二个“妈”读轻声ma,不是mā;“花儿”读huār,不是huā ér;“一”在“一个”中读yí,不是yī。
- 轻声不写声调符号,也不加数字,就写
ma、de、le - 儿化音统一用
r尾,如tiǎor、jiānr,不要写“儿”字或分音节 - 变调(如“你好”中“一”读
yí)需结合词组判断,单字ruby无法承载该逻辑,必须按词级标注:一个
真正难的不是写对标签,而是准确判断每个字在具体语境中的实际发音——这一步没法交给 HTML 或 JS 自动完成,必须由人来定。标错读音的ruby,比不标还容易误导。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











