html5 页面语言声明必须且仅在 根标签中设置，如 ；子元素 lang 仅用于局部语言切换；团队强制要求根 lang 存在、值符合 bcp 47 规范（小写、无下划线）、禁止冗余或错误写法。

HTML5 中页面语言声明必须写在 html> 根标签上，且仅在此处设置，这是团队代码标准的硬性要求，不是可选项。

lang 属性必须出现在 开始标签内

所有 HTML 文件第一行是 ，第二行必须是 <code>（或其他合法 BCP 47 值）。不能省略，不能写成 后再补，也不能放在 或任意子元素里——这些位置的 lang 对整页语言识别完全无效。

• 屏幕阅读器、搜索引擎、翻译插件只读取这一处值
• 团队统一使用 zh-CN，不接受 zh、zh-Hans、zh-cmn-Hans 等已废弃或非标准写法
• 繁体地区项目按实际部署地选用 zh-HK、zh-TW 等，但需提前在项目配置文档中明确

子元素 lang 仅用于局部语言切换

当页面中出现非主语言内容时（如英文引用、日文术语、嵌入的外文 API 响应），才在对应元素上单独加 lang。例如：

Article To Html

文章转信息图。将文章/笔记转化为手机可读的 HTML 信息图，自动匹配视觉风格。触发场景：文章转图、笔记转图、信息图、转小红书图、做张图、可视化这篇文章、文生图。

下载

• <p lang="en">The term “semantic HTML” means...</p>
• <blockquote lang="ja">HTML5 はウェブ標準です。</blockquote>
• 这种写法不影响根 lang，也不替代它

团队落地执行要点

把语言声明纳入代码审查清单和模板脚手架中，避免人工遗漏：

• 新建 HTML 文件模板强制包含：
• CI 流水线增加检查规则：扫描所有 .html 文件，若缺失根 lang 或值不符合 BCP 47（如含下划线错误、大小写混用、过时标签），自动报错
• 前端组件库中所有可复用的布局组件（如 <pagelayout></pagelayout>）默认继承根 lang，禁止在内部硬编码 lang

常见误写与修正对照

团队培训中重点强调以下错误写法，统一替换为标准形式：

• ✘ → ✔
• ✘ → ✔
• ✘ → ✔ （小写优先）
• ✘ → 删除该属性，确保只在 上存在

前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！