HTML国际化降级核心是保障页面在资源缺失或异常时仍能正常渲染默认内容，需预置内联语言包、显式声明符合BCP 47标准的lang属性、安全替换textContent、构建期静态校验key覆盖，避免白屏、结构破坏或无障碍失效。
HTML国际化（i18n）降级的核心不是“翻译失败就报错”，而是让页面在语言资源缺失、加载异常或解析错误时，仍能渲染出可读、可用、无障碍的默认内容——通常就是源语言（如英文）文本，且不破坏结构、不阻塞交互、不引发 JS 错误。
lang 属性写错或缺失时，屏幕阅读器怎么 fallback
浏览器和辅助技术不会因为 lang 值非法（比如写成 lang="en-us" 而非标准 en-US）就崩溃，但会降低语音合成准确率；若完全缺失 lang，部分读屏软件可能默认用系统语言朗读，导致中英文混读错乱。
- 必须在
<html>标签上显式声明lang，且值需符合 BCP 47 标准（如zh-CN、ja-JP），不能写zh或chinese - 服务端渲染时，优先从请求头
Accept-Language推导并注入lang，避免前端 JS 动态设置导致 FOUC 或读屏延迟 - 不要依赖 JS 设置
document.documentElement.lang作为唯一来源——它晚于 DOM 解析，读屏软件可能已按初始空值开始朗读
JSON 语言包加载失败，如何避免页面白屏或报错
直接 fetch('/locales/zh-CN.json') 后 .then(data => render(data)) 是高危写法：网络中断、404、CORS、JSON 格式错误都会触发 catch，若没兜底逻辑，render() 不执行，DOM 就卡在占位符或空节点。
- 预置内联默认语言包：把英文文案以
<script type="application/json" id="i18n-fallback">{...}</script>写在<head>，确保零网络依赖下也能初始化 - 加载失败时，立即回退到该内联包，而非显示 “Loading…” 或空白 —— 用户感知不到“切换”，只看到内容正常出现
- 对
JSON.parse()做 try/catch，错误日志需带上文件路径和原始响应体片段（截取前 200 字符），便于定位是构建遗漏还是 CDN 覆盖问题 - 禁止用
import('./locales/zh-CN.json')动态导入语言包：Webpack/Vite 的 code-splitting 会生成独立 chunk，加载失败无 fallback 路径，且无法静态分析依赖
HTML 中内联 i18n 占位符（如 {{title}}）怎么安全替换
模板字符串替换本身不危险，但若替换逻辑依赖未加载的语言包、或正则匹配误伤 HTML 属性（如把 data-title="{{title}}" 里的 {{title}} 替换掉），就会破坏结构甚至引入 XSS。
立即学习“前端免费学习笔记（深入）”；
- 只替换
<body>内文本节点（node.nodeType === 3），跳过所有元素节点、属性、注释和 script/style 内容 - 使用
textContent而非innerHTML更新，彻底规避 HTML 注入风险；如需富文本，必须由后端预处理并转义，前端只做纯文本映射 - 占位符语法避免用双大括号：改用更少见的组合如
[i18n:home.title]，防止与 Vue/React 模板冲突，也降低被正则误匹配概率 - 替换前检查 key 是否存在：缺失 key 时不留空，也不 fallback 到 key 名本身（如显示
home.title），而应回退到内联默认包中的对应值
多语言 HTML 构建产物怎么避免漏译、错译、格式错乱
靠人工核对几十个页面的多语言 HTML 几乎不可行；工程化关键在于把校验提前到构建阶段，而非等测试或上线后才发现 <h1>{{missing.key}}</h1>。
- 在 Vite/Webpack 构建流程中集成
i18n-allyCLI 或自研扫描器，遍历所有 HTML/JSX 文件，提取全部[i18n:xxx]key，比对语言包 JSON 的 keys，缺失项直接exit 1 - 校验 JSON 值是否含未闭合标签、多余引号、控制字符（如 \u202E 镜像文字），这些在编辑器里看不见，但会导致 HTML 解析失败或渲染异常
- 对
lang属性做静态检查：htmlhint配置启用attr-value-language-valid规则，拒绝lang="cn"这类非法值 - CI 流程中生成「语言覆盖率报告」：统计每个语言包覆盖了哪些页面的哪些区块，暴露长期无人维护的冷门页面文案
最易被忽略的点是：国际化降级不是“翻译兜底”，而是整个 HTML 文档生命周期的容错设计——从 lang 属性校验、语言包加载时序、占位符安全替换，到构建期静态扫描，每一环都可能成为单点故障。一旦某处没设 fallback，用户看到的就不是“简体中文少了几个词”，而是整个按钮失灵、表单无法提交、甚至页面结构错乱。
