用data-i18n标记元素+JSON语言包管理多语言文本，解耦翻译与结构；优先textContent更新文字，避免innerHTML导致事件丢失；切换时局部刷新并同步更新document.documentElement.lang及Intl格式化实例。
如何用 data 属性 + JSON 文件管理多语言文本
直接把翻译文本硬编码在 HTML 里或塞进 JS 字符串，后期维护和协作会迅速失控。推荐用 data-i18n 标记需要翻译的节点，再配合外部 JSON 文件按语言组织键值对。
例如：
<h1 data-i18n="home.title">首页</h1>，对应
zh.json 中 {"home.title": "首页"}，en.json 中 {"home.title": "Home"}。这样 DOM 结构干净，翻译内容与逻辑解耦。
- 避免用
innerHTML直接替换整个节点——会丢失事件监听器或已初始化的组件状态 - 优先用
textContent更新文字内容；若需保留内嵌标签（如<strong></strong>），则用innerHTML但必须确保翻译值已做 HTML 转义或白名单过滤 - JSON 文件建议按功能模块拆分（如
common.json、form.json），再用 Promise.all 并行加载，减少首屏等待
切换语言时如何避免页面闪动和状态丢失
语言切换不是简单重载页面或暴力替换所有文本。关键在于：保持当前路由、表单输入值、滚动位置、以及第三方组件（如日期选择器）的语言同步。
做法是监听语言变更后，只触发一次「局部刷新」：遍历所有带 data-i18n 的元素，查表更新其内容，同时调用 Intl.DateTimeFormat 或 Intl.NumberFormat 重新格式化时间/数字字段。
立即学习“前端免费学习笔记（深入）”；
把任意文章或文档内容转换成精美的全屏翻页 HTML 演示文件（幻灯片风格）。当用户发来一篇文章、文档链接、Markdown 内容、或粘贴的文本，并且希望生成演示用的 HTML 时触发。支持任意内容来源：iWiki 链接、KM 链接、本地文件路径、直接粘贴的文本。生成的 HTML 文件保存到本地工作区，并通过企微直接发送给用户。触发词示例：帮我把这篇文章做成PPT、转成演示文档、生成HTML幻灯片、做个演示、转成可以演示的格式、article to deck、make a slide。
- 不要用
window.location.reload()—— 用户正在填写的表单会清空，且 SEO 不友好 - 切换前用
getComputedStyle记录当前滚动位置，更新完 DOM 后用window.scrollTo()恢复，否则页面会跳回顶部 - 如果用了
moment.js，记得调用moment.locale('en')；若用原生Intl，需重建所有格式化实例，不能复用旧对象
如何让服务端和前端共享同一套语言检测逻辑
浏览器 navigator.language 不可靠（用户可能改过设置，或使用隐私模式），而纯前端检测又无法支持 SSR 场景。最稳的方式是：由服务端通过 Accept-Language 请求头解析出首选语言，并注入为全局 JS 变量或 的 lang 属性。
前端初始化时优先读取 document.documentElement.lang， fallback 到 navigator.language，再 fallback 到默认语言（如 en）。这样 CSR 和 SSR 渲染结果一致，SEO 友好，也避免首次渲染语言错乱。
- Node.js 后端可用
accepts库解析Accept-Language，比手动正则更准 - 不要依赖
localStorage存语言偏好来覆盖服务端判断——它可能过期，且新设备首次访问没值 - 如果用户手动切换语言，应同时发请求通知服务端（如
/api/locale），用于后续接口返回对应语言的错误消息等
为什么 lang 属性和 hreflang 不能省略
lang 不只是给 CSS 伪类 :lang() 用的，屏幕阅读器、搜索引擎、拼写检查、字体回退都依赖它。漏掉会导致语音朗读用错音调，Google 搜索结果中语言标识不准确，甚至某些中文字体在英文段落里无法正确渲染标点。
hreflang 则关系到多语言站点的 SEO 权重分配。比如 <link rel="alternate" hreflang="en" href="https://example.com/en/"> 告诉 Google 这是英文版，和 zh 版互为替代，而非重复内容。
- 动态切换语言时，务必同步更新
document.documentElement.lang，否则辅助技术仍按旧值工作 -
hreflang必须成对/成组出现，有en就得有zh，且要包含x-default作为兜底 - 不要用
meta http-equiv="content-language"替代lang属性——W3C 已弃用，且语义不同
