lang属性必须在首屏html中正确设置，js动态修改无效；需按bcp 47标准精确标注全局与局部语言，影响无障碍、seo及渲染行为。
lang 属性必须在首屏 HTML 中写对，JS 动态改 document.documentElement.lang 基本无效——屏幕阅读器不重载语音引擎，Chrome 翻译按钮不激活，SEO 也收不到信号。
根元素
这是整个页面的语言基调，影响字体回退、拼写检查默认行为、搜索引擎索引方向。它不是“可有可无”的装饰属性。
- 服务端渲染（SSR）项目：根据
Accept-Language请求头或用户登录态，在模板中直接注入，比如 - 静态站点（Hugo/Jekyll）：每个语言版本生成独立 HTML 文件，
lang硬编码进模板，不依赖 JS - 纯前端 SPA：语言切换时建议整页刷新（
window.location.href），避免用 JS 改根节点后出现辅助技术“卡旧语言”的问题 - 值必须符合 BCP 47 标准：用
zh-CN，别用zh_CN或Chinese；en-US不能写成en_US；zh-Hans仅在明确排除繁体场景时才用
局部混排内容必须显式加 lang 属性
只定义主语言，不影响内部英文术语、日文引用、代码注释的识别。浏览器和屏幕阅读器只认具体元素上的 lang 值。
- 英文单词/缩写：
<p>我们使用 <span lang="en">React Router</span> 实现路由</p><div class="aritcle_card flexRow artxards"> <div class="artcardd flexRow"> <a class="aritcle_card_img" rel="nofollow" href="/xiazai/skill5117" title="HTML Extract"><img src="https://img.php.cn/upload/skill/000/000/081/179033952939354.jpg" alt="HTML Extract" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a> <div class="aritcle_card_info flexColumn"> <a rel="nofollow" href="/xiazai/skill5117" title="HTML Extract" class="overflowclass">HTML Extract</a> <p class="overflowclass">使用 MinerU 从 HTML 页面和文件中提取内容，将 HTML 转换为保持标题、列表、表格及文本层次结构的干净、结构化 Markdown。F...</p> </div> <a rel="nofollow" href="/xiazai/skill5117" title="HTML Extract" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a> </div> </div> - 代码块里的命令行示例：
<pre class="brush:php;toolbar:false;" lang="en">curl -X POST /api</pre>（别用lang="bash"，那不是合法语言码） - 整段外文内容：
<blockquote lang="ja">ありがとうございます</blockquote> - 避免滥用：
<div lang="en"> 这类无语义容器上加 <code>lang，容易干扰父级:lang()样式匹配，也违背 HTML 语义原则:lang()伪类样式匹配要小心CSS 的
:lang()不是简单字符串匹配，它会继承父级语言，但选择器写法必须严格对应。-
:lang(zh)只匹配lang="zh"，不匹配lang="zh-CN"或lang="zh-Hans" -
:lang(zh-CN)也不匹配lang="zh-Hans"，二者互不兼容 - 若需覆盖多种变体，用
[lang|="zh"]（注意是竖线|=）：它能匹配zh、zh-CN、zh-Hans、zh-TW等所有以zh开头的值 - 想给日文强调文字换样式？
em:lang(ja) { text-emphasis: dot; }是可行的，但前提是em或其任意祖先确实带了lang="ja"
lang和hreflang别混用这是两个完全不同的机制，一个管“内容语言”，一个管“链接关系”。搜索引擎靠
hreflang分流，但用户打开页面后，一切渲染逻辑只看lang。- 每个语言版页面都要在
里放完整且一致的hreflang块，例如：<link rel="alternate" hreflang="en" href="https://example.com/en">和<link rel="alternate" hreflang="ja" href="https://example.com/ja"> -
hreflang="x-default"强烈推荐加，作为兜底页，但它的值必须指向真实存在的页面 -
href必须是绝对 URL，协议、域名、路径全对，不能有重定向 - 页面自身的
必须和它声明的hreflang="en"完全一致，否则搜索引擎会认为你在撒谎
最常被忽略的一点：多语言混排时，
lang不是“设一次就完事”的全局开关。它需要按语义粒度逐层标注——从整页到段落，再到短语甚至单个词。标错或漏标，对普通用户可能只是字体微调，对屏幕阅读器用户却是发音错乱、停顿失序、理解中断。 -
