lang属性必须在首屏html的标签中正确声明，js动态修改document.documentelement.lang无效；值须严格符合bcp 47规范（如zh-cn），局部多语言内容需显式标注lang。
检查 document.documentElement.lang 是否在首屏HTML中写对
lang 属性必须在初始 HTML 字符串里就存在，JS 后续赋值基本无效。浏览器和屏幕阅读器只读取解析时的 html lang="...">，改 document.documentElement.lang 不会触发重解析。
常见错误包括：
- SPA 项目只在 JS 里执行
document.documentElement.lang = "en-US"，但首屏 HTML 仍是 - 服务端模板硬编码
lang="zh"，没根据用户请求头或登录态动态注入 - 静态站点生成工具（如 Hugo）把多语言版本混在同一个 HTML 文件里，lang 值没随语言版本切换
验证方式：打开 DevTools → Elements 面板，直接看 标签的原始属性值，不是靠 JS Console 查 document.documentElement.lang。
确认 lang 值是否符合 BCP 47 规范
写错格式不会报错，但等于没写。浏览器只按标准字符串精确匹配，不“智能纠错”。
必须满足：
- 小写字母 + 连字符（
-），不能用下划线（_）或大写 - 地区码建议带上：用
zh-CN，不用zh；用en-US，不用english - IANA 不收录三段式码，如
zh-Hans-CN会被 Chrome 静默降级为zh
典型失效写法：zh_cn、ZH-CN、chinese、zh-Hans（部分语音引擎不识别）、cn。
验证局部多语言内容是否显式标注
只定义主语言，不影响内部英文、日文等文本的识别。表格、代码块、引文这些地方必须单独加 lang，继承不存在。
错误写法：
<table lang="en"> → 表格本身无语言语义，<code><td> 仍按 <code>zh-CN渲染<div lang="ja">こんにちは → 虽然能朗读，但语义不合理，应优先用 <code><p lang="ja"></p>或<blockquote lang="ja"></blockquote><pre class="brush:php;toolbar:false;">curl -X POST</pre> → 缺少 <code>lang="bash"，语法高亮和翻译工具无法识别上下文- 某些浏览器（如旧版 Safari）对
:lang(zh)的子类匹配不一致，zh-CN可能不触发:lang(zh)，建议显式写:lang(zh-CN), :lang(zh-Hans) - 字体链里没放对应语言专用字体，比如
:lang(ja) { font-family: "Helvetica", sans-serif; }，Helvetica 不支持日文，浏览器直接 fallback 到 sans-serif，结果用英文字体渲染假名 -
lang值大小写不一致也会断链，比如但某处写了<p lang="en-us"></p>，Safari 可能拒绝匹配
正确做法：给每个需要独立语言处理的元素（<td>、<code><th>、<code><code>、<blockquote></blockquote>）显式加 lang，且值要真实反映该内容的语言。
排查 :lang() CSS 和字体回退是否被连带影响
:lang(zh-CN) 规则不生效，90% 是因为根节点 lang 写错或缺失。但还有两个隐藏坑：
真正难的不是设对一个 lang="zh-CN"，而是让每个动态插入、跨框架、第三方脚本生成的文本节点，都带着准确的语言上下文被解析——这点最容易被忽略，也最难自动化覆盖。
