lang 和 xml:lang 必须同时写在 标签上且值完全一致，xhtml 1.0 要求二者共存以保障浏览器及屏幕阅读器兼容性；html5 中 xml:lang 非冗余，是 xml 工具链和 ssr/i18n 场景的关键支持。
lang 和 xml:lang 必须同时写在
只写 lang 或只写 xml:lang 都不保险。XHTML 1.0 规范明确要求两者共存，浏览器（尤其是旧版 IE、Firefox）和部分屏幕阅读器会分别依赖其中一个。现代 HTML5 文档虽已不强制 xml:lang，但保留它仍能提升兼容性——特别是当页面被当作 XHTML 解析（如通过 application/xhtml+xml MIME 类型）时。
正确写法是：
注意两点：值必须完全一致；两个属性都在同一xml:lang 在 HTML5 中不是冗余，而是“向下兼容锚点”
xml:lang 不是历史包袱，它是 DOM 层面对 XML 工具链的显式支持。比如某些 SSR 框架（如 Next.js 的 app/router）或静态站点生成器（如 Hugo）在输出 XML 友好格式时，会检查 xml:lang 是否存在并合法。若缺失，可能导致 i18n 插件 fallback 到 navigator.language，而非你声明的语言。
常见错误包括：
-
—— 缺xml:lang，XML 解析器无法识别语言上下文 -
—— 缺lang，Chrome 翻译按钮不出现 -
—— 大小写不一致，部分语音引擎（如旧版 JAWS）会静默忽略xml:lang
不要用 xml:lang 替代 lang 去局部标注
xml:lang 是 XML 规范定义的全局语言属性，在 HTML 中仅被允许用于 根元素。W3C 明确指出：在非 XML 文档中（即普通 text/html），xml:lang 仅在 上有效；写在 <p></p>、<span></span> 等子元素上会被浏览器忽略。
所以局部语言标注只能用 lang：
- ✅
<blockquote lang="fr">Je suis français.</blockquote> - ❌
<blockquote xml:lang="fr">…</blockquote>（无效） - ❌
<span xml:lang="en">API</span>（不会触发 IDE 英文高亮，也不会影响屏幕阅读器发音）
验证是否真正共存生效
光写对了还不够，得确认浏览器和辅助技术真读到了。打开 DevTools 控制台，执行：
document.documentElement.lang === document.documentElement.getAttribute('xml:lang')返回 true 才算基础一致。再检查：- 右键页面是否有“翻译成中文”选项（
lang生效） - 用 VoiceOver / NVDA 朗读
<code lang="en">useState，听是否切换为英文发音（lang局部生效） - 运行
Intl.getCanonicalLocales("zh-CN")，看是否返回["zh-CN"]（BCP 47 格式校验）
lang 和 xml:lang 时，没做 htmlspecialchars() 转义，导致引号被截断或注入，整个属性丢失。前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
