lang属性必须写在html根标签上，如；在html5中已被弃用，浏览器、屏幕阅读器和搜索引擎均忽略，无法影响断字、字体匹配等实际行为。

必须在 html 标签上写 lang 属性，其他任何位置或方式都不可靠。

为什么不能用 <meta http-equiv="Content-Language">

这个写法在 HTML5 中已被明确弃用。Chrome、Firefox、Safari 完全忽略它；屏幕阅读器不读、搜索引擎不索引、翻译工具不识别。你写了它却没写 lang，等于没声明语言。它本意是声明“目标受众语言”，不是内容实际语言——语义错位，且无法影响断字、字体匹配、拼写检查等真实行为。

lang 值怎么选：zh-CN、zh-Hans、zh 的区别

三者不是随意替换的同义词，会影响中文字体渲染、断行规则和辅助技术响应：

• zh-CN：简体中文 + 中国大陆规范（推荐国内大多数网站）
• zh-Hans：仅表示“简体字”，不指定地区（适合开源文档、全球华人项目）
• zh：过于宽泛，iOS Safari 可能降级为英文语音引擎，部分 CSS font-language-override 无法触发正确字形

旧版 Edge（EdgeHTML）曾忽略 zh-Hans，但现代 Chromium / Firefox 已支持良好。

多语言内容怎么处理

主语言固定在 html 上，局部外语用子元素覆盖：

Article To Html

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

下载

• 英文引文：<p>原文是<span lang="en">The Art of Computer Programming</span></p>
• 日文术语：<p lang="ja">プログラミング</p>
• 不要在 title 或属性值里尝试嵌套语言——HTML 不允许标签，目前无解

第三方组件库（如 Ant Design）内部文案不读取页面 lang，它们依赖自己的 locale 配置。光设 lang="ja" 不会让按钮变日文，那是组件逻辑层的事。

动态切换语言时最容易踩的坑

运行时用 JS 改 document.documentElement.lang 是无效的：

• 屏幕阅读器不会重读页面
• 搜索引擎不会重新索引
• CSS :lang() 选择器可能不更新（取决于浏览器实现）

真正可行的方式只有两种：服务端根据 Accept-Language 或路由（如 /en/about）直接输出带对应 lang 的 HTML；或静态站生成多份文件（index-zh.html、index-en.html）。JS 切换只适合 demo 场景，且必须同步更新所有已渲染元素的 lang 并加 aria-live 提示。

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