生僻字显示方块或问号是因系统缺字而非HTML错误,需通过font-family回退、显式加载Noto等高覆盖字体并检测字形支持;多音字注音须严格一一对应每个汉字,用单独包裹,避免语义与语音层逻辑混淆。

生僻字显示为方块或问号,本质是字体缺字
不是 HTML 写错了,而是你系统里没装能画出那个字的字体。浏览器按 font-family 顺序找字体,主字体缺字就 fallback 到下一个——但备选字体很可能也没覆盖到扩展 B 区(如“䶮”“龘”)甚至 C 区字符。肉眼看到方块,说明当前渲染链路中没有任何字体提供了该字形的 glyph。
实操建议:
立即学习“前端免费学习笔记(深入)”;
- 先用开发者工具(F12 → Elements → 选中文字 → Computed → font-family)确认最终生效的是哪个字体
- 检查该字体文件是否真的包含目标字:用
fonttools ttx解析 TTF,搜索对应 Unicode 码点(如 U+20000)是否在cmap表中存在映射 - 临时验证可执行:
document.body.style.fontFamily = "'Noto Sans CJK SC', sans-serif",Noto 字体对扩展区支持最全 - 生产环境别只靠 CSS fallback,需在构建流程中加入字体覆盖率扫描(如用
fonttools+chardet预检文案)
多音字注音必须一对一,不能塞进一个 <rt></rt>
<ruby></ruby> 不是拼音容器,它是语义化“字-音”绑定单元。写成 <ruby>否<rt>fǒu/pǐ</rt></ruby> 会让屏幕阅读器朗读“fǒu slash pǐ”,也违反 W3C 对 <rt></rt> 的定义:它必须精确对应前一个字符的发音。
实操建议:
立即学习“前端免费学习笔记(深入)”;
- 每个汉字单独套一层
<ruby></ruby>:<ruby>否<rt>pǐ</rt></ruby><ruby>极<rt>jí</rt></ruby> - 若需提供上下文读音提示(如“否”在“否定”中读 fǒu),用
data-pinyin或title作为辅助,不干扰主结构 - 避免用 CSS 把多个
<rt></rt>挤在一起实现“连读效果”,这会破坏语音合成器的停顿逻辑
Chrome/Edge 渲染生僻字时 fallback 不可控,得主动干预
Chromium 系列浏览器的字体回退策略是黑盒行为:它可能跳过你声明的第二字体,直接选系统默认的“SimSun”,而 SimSun 对扩展区基本不支持。更糟的是,同一段 HTML 在 Windows 和 macOS 上 fallback 结果可能完全不同。
实操建议:
立即学习“前端免费学习笔记(深入)”;
- 不要依赖
font-family: "HanDian Song", "Noto Sans CJK SC", sans-serif这种纯声明——加@font-face显式加载高覆盖字体,并设unicode-range精确控制加载范围 - 对关键生僻字(如古籍专有名词),用
font-display: optional避免 FOIT,同时搭配fallback属性指定降级字体 - 服务端渲染时,可用 Puppeteer 启动 Chromium 实例,调用
page.evaluate(() => document.fonts.check("12px 'Noto Sans CJK SC'"))动态检测字体可用性,再决定是否插入备用方案
SSML 强制发音和 <ruby></ruby> 注音是两套逻辑,别混用
Edge 的大声朗读(Read Aloud)走的是系统 TTS 引擎,它压根不解析 <ruby></ruby>;而 <ruby></ruby> 是给视觉+辅助技术(如 VoiceOver)用的语义结构。试图用 SSML 的 <phoneme></phoneme> 去“修复” <ruby></ruby> 的读音,等于在两个不通信的通道上各自打补丁。
实操建议:
立即学习“前端免费学习笔记(深入)”;
- 视觉层用
<ruby></ruby>+<rt></rt>提供标准拼音,确保无障碍访问合规 - 语音层单独处理:对需要干预的词,包裹
<span aria-label="yún xiāo">云霄</span>,TTS 优先读aria-label值 - 若必须用 SSML(如内网知识库),确保页面已开启
edge://settings/accessibility中的“允许网页使用 SSML 控制语音”,且仅对静态内容生效
<ruby></ruby>,而是没意识到:字体缺失导致的方块字,会让 <ruby></ruby> 失去载体;而多音字标注一旦脱离“字-音严格一一对应”,就会让所有依赖它的下游(语音、翻译、索引)全部失效。这两件事得同步解决,不能只修前端 DOM。



















