lang属性必须在首屏HTML中正确设置，JS动态修改无效；需按BCP 47标准精确标注全局与局部语言，影响无障碍、SEO及渲染行为。
lang 属性必须在首屏 HTML 中写对，JS 动态改 document.documentElement.lang 基本无效——屏幕阅读器不重载语音引擎，Chrome 翻译按钮不激活，SEO 也收不到信号。
根元素 <html lang="xx"> 必须设对
这是整个页面的语言基调，影响字体回退、拼写检查默认行为、搜索引擎索引方向。它不是“可有可无”的装饰属性。
- 服务端渲染（SSR）项目：根据
Accept-Language请求头或用户登录态，在模板中直接注入，比如<html lang="ja-JP"> - 静态站点（Hugo/Jekyll）：每个语言版本生成独立 HTML 文件，
lang硬编码进模板，不依赖 JS - 纯前端 SPA：语言切换时建议整页刷新（
window.location.href），避免用 JS 改根节点后出现辅助技术“卡旧语言”的问题 - 值必须符合 BCP 47 标准：用
zh-CN，别用zh_CN或Chinese；en-US不能写成en_US；zh-Hans仅在明确排除繁体场景时才用
局部混排内容必须显式加 lang 属性
<html lang="zh-CN"> 只定义主语言，不影响内部英文术语、日文引用、代码注释的识别。浏览器和屏幕阅读器只认具体元素上的 lang 值。
- 英文单词/缩写：
<p>我们使用 <span lang="en">React Router</span> 实现路由</p> - 代码块里的命令行示例：
<pre lang="en">curl -X POST /api</pre>（别用lang="bash"，那不是合法语言码） - 整段外文内容：
<blockquote lang="ja">ありがとうございます</blockquote> - 避免滥用：
<div lang="en">这类无语义容器上加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。
- 每个语言版页面都要在
<head>里放完整且一致的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，协议、域名、路径全对，不能有重定向 - 页面自身的
<html lang="en">必须和它声明的hreflang="en"完全一致，否则搜索引擎会认为你在撒谎
最常被忽略的一点：多语言混排时，lang 不是“设一次就完事”的全局开关。它需要按语义粒度逐层标注——从整页到段落，再到短语甚至单个词。标错或漏标，对普通用户可能只是字体微调，对屏幕阅读器用户却是发音错乱、停顿失序、理解中断。
