页面语言声明是否生效，首先检查<html>标签的lang属性是否符合BCP 47规范，如zh-CN或en-US，必须小写加连字符；其他位置或非法格式均无效。
直接看 HTML 根节点的 lang 属性值是否合法
页面语言声明是否生效，第一眼就该盯住 <html> 标签。浏览器、屏幕阅读器、搜索引擎只认这个位置的 lang，其他地方写了等于没写。打开 DevTools 的 Elements 面板，定位到最外层 <html>，检查它有没有 lang 属性，值是不是符合 BCP 47 规范。
常见非法写法包括：lang="zh"（太宽泛）、lang="chinese"（非标准）、lang="zh_CN"（下划线不合法）、lang="ZH-CN"（大小写混用，部分辅助技术会忽略）。必须是小写+连字符，首选 lang="zh-CN"（简体中文）或 lang="en-US"（美式英语）。
-
<html lang="zh-CN">✅ 合法、推荐、全链路兼容性最好 -
<html lang="zh">⚠️ 虽不报错，但 iOS VoiceOver 可能跳过中文 TTS 引擎 -
<body lang="zh-CN">❌ 完全无效，对页面级语言无任何作用 -
<html lang="">❌ 空值被当“未知语言”，Chrome 翻译按钮直接消失
用浏览器 DevTools 快速验证 document.documentElement.lang
控制台一行命令就能确认当前解析出的语言值是否如你所设。在 Console 中执行：
document.documentElement.lang
返回结果应为 "zh-CN" 这类规范字符串。如果返回空字符串、"zh" 或 undefined，说明 HTML 源码里没写对，或者被 JS 动态覆盖了（但注意：JS 后期修改对已激活的屏幕阅读器基本无效）。
立即学习“前端免费学习笔记（深入）”；
别信 document.querySelector('html').getAttribute('lang') ——它可能读到的是 DOM 属性快照，而辅助技术依赖的是解析时的原始值。真正关键的是 document.documentElement.lang 这个只读属性，它反映 HTML 解析器实际拿到的值。
使用 PptxGenJS 和 Python 解析，将结构化的 HTML/CSS 幻灯片内容转换为原生、可编辑的 PowerPoint（.pptx）演示文稿。
检查多语言局部标注是否语义合理
局部 lang 不是装饰，得有明确语义支撑。比如引文、术语、代码标识符、外文人名地名才加，不能为了“看起来规范”给每个英文单词都套一层 <span lang="en">API</span>。
- ✅ 合理：
<blockquote lang="fr">Je vous remercie.</blockquote> - ✅ 合理：
<code lang="en">useState</code>（帮助 IDE/语法工具识别上下文） - ❌ 过度：
<p>欢迎使用 <span lang="en">Dashboard</span></p>（DOM 膨胀、可访问性树变慢、无实际收益）
还要注意：CSS 的 :lang(zh) 选择器能否匹配，取决于 <html lang="zh-CN"> 是否存在且合法。如果样式没生效，先查根节点 lang，再查是否有空格或非法字符。
动态页面中 SSR 和客户端渲染的断点差异
SPA 或服务端渲染项目最容易在这里翻车：HTML 初始响应里 <html lang="zh-CN"> 是对的，但后续路由切换或语言切换时仅靠 JS 改 document.documentElement.lang = "ja-JP"，屏幕阅读器大概率不会重读。
真正起效的方式只有两种：
- 服务端输出正确值（Next.js 在
app/layout.tsx用<html lang={locale}>，PHP 模板里用<html lang="= htmlspecialchars($lang, ENT_QUOTES) ?>">） - 若必须客户端改，需同步触发强制重读信号，例如
document.title = document.title（空赋值），但效果不稳定，不推荐作为主方案
最容易被忽略的一点：第三方脚本插入的文本节点（比如评论框、广告位、埋点 SDK 渲染的内容），默认继承 <html> 的语言，但若它们内部含外文又没显式标注 lang，就会造成语音朗读错乱——这不是你的错，但得主动兜底。
