HTML5中lang属性缺失虽不致页面崩溃，但会严重影响屏幕阅读器语音合成、搜索引擎语言判定、浏览器自动翻译及CSS断字规则；必须设在标签上且值符合BCP 47标准（如zh-CN），多语言内容需局部嵌套lang属性。
HTML5 中语言声明缺失不会导致页面崩溃，但会影响屏幕阅读器、搜索引擎理解内容语义，甚至干扰字体渲染和文本方向。关键检查点不是“有没有 lang 属性”，而是它是否出现在 标签上、值是否合理、是否被覆盖或遗漏。
将 Markdown 文章转换为微信公众号兼容的纯 HTML 格式。当用户要求"转成微信格式"、"生成公众号文章 HTML"、"排版到微信草稿箱"、"微信粘贴格式"时触发。输出带内联样式的纯 HTML，微信编辑器可直接渲染，无需额外适配。支持标题、段落、列表、粗体、行内代码、表格、引用块、代码块、配图的完整转换。
确认 lang 属性是否真实存在且位置正确
打开浏览器开发者工具 Elements 面板，直接查看 开始标签。必须满足：
- lang 是 的直接属性（不能写在 或某个 <div> 上）
- 值符合 BCP 47 标准，例如 <code>lang="zh"、lang="zh-CN"、lang="en-US"；避免写成 lang="chinese" 或 lang="cn" 这类非标准值
- 若页面含多语言混合内容（如中英双语段落），主语言仍由 定义，局部切换用 <span lang="en"></span>
快速验证是否生效的三步法
在控制台输入以下命令，逐条运行观察结果：
- document.documentElement.lang → 应返回字符串（如 "zh-CN"），若返回空字符串或 undefined，说明缺失或未设置
- document.documentElement.getAttribute("lang") → 区分“属性存在但值为空”和“属性根本不存在”
- getComputedStyle(document.documentElement).direction → 若设为 lang="ar" 却返回 "ltr"，可能被 CSS 强制覆盖，需排查 direction 或 unicode-bidi 声明
常见缺失场景与修复方式
语言声明常在以下环节被漏掉或覆盖：
- 模板引擎（如 EJS、Nunjucks）中 未传参，渲染后变成
- SSR 框架（如 Next.js、Nuxt）配置未启用 i18n，或 htmlAttrs 插件未注入 lang
- 构建工具（Vite、Webpack）生成的 HTML 入口文件硬编码为 ，缺少动态插入逻辑
- 多语言切换时仅改了 的 class，却忘了同步更新
修复建议：
- 手动补全：在源 HTML 文件顶部 标签中加入 lang="zh-CN"（中文站推荐）
- 自动注入：使用插件如 vite-plugin-html 或 html-webpack-plugin 的 templateParameters 注入语言变量
- 框架方案：Next.js 启用 experimental.i18n，Nuxt 使用 head.htmlAttrs 配置
W3C 验证器为何不报错？要怎么主动发现
lang 属性在 HTML5 中是可选的，W3C Validator 不会将其列为错误（Error），最多标为提示（Info）或忽略。但它属于 WCAG 2.1 AA 级可访问性要求（SC 3.1.1），缺失会导致审计工具（如 axe、Lighthouse）明确扣分。
主动发现方法：
- 在 Lighthouse 中运行「Accessibility」审计，查看 “Document has a valid language” 是否通过
- 使用浏览器扩展 axe DevTools，运行后直接高亮缺失 lang 的 节点
- 控制台执行：!document.documentElement.lang ? console.warn("⚠️ lang 属性缺失") : console.log("✅ lang =", document.documentElement.lang)
