HTML编辑器本身不支持多语言切换，需宿主页面驱动其UI文本更新；直接修改document.documentElement.lang无效，因编辑器初始化后不再监听lang变化，必须通过初始化配置或API切换语言，并正确处理DOM节点的data-i18n及BCP 47标准lang属性。
HTML 编辑器本身不内置多语言切换能力，所谓“编辑器多语言”，实际是指它所运行的宿主页面（如 CMS 后台、低代码平台、富文本配置页）支持语言切换，并让编辑器 UI 文本（按钮、菜单、提示）随宿主语言动态更新。关键不是改编辑器源码，而是正确标记 + 驱动它的 DOM 节点。
为什么直接改 document.documentElement.lang 不会让编辑器变中文
多数富文本编辑器（如 TinyMCE、CKEditor、Quill）在初始化时读取一次宿主页面语言或硬编码英文，之后不再监听 lang 变更。只改根节点语言，编辑器内部的 toolbar 按钮、tooltip、dialog 标题仍显示旧语言——它们是 JS 动态插入的 DOM，没绑定 data-i18n，也没响应 lang 属性变化。
- 常见错误现象：
TinyMCE的“Bold”按钮始终是英文，即使<html lang="zh-Hans">已设好 - 根本原因：编辑器初始化后，其 UI 元素脱离了宿主页面的翻译驱动链，需手动触发重渲染或调用其内置 locale 切换 API
- 部分编辑器（如 CKEditor 5）提供
config.language和config.localization，但必须在初始化前传入，运行时切换需 destroy + re-init
data-i18n 怎么打到编辑器 UI 元素上才有效
不能指望编辑器自动识别你加的 data-i18n。只有两类情况能生效：
anything-to-html
下载
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML，替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度，HTML 能同时承载排版、表格、SVG 等。
- 你使用的是轻量级自研编辑器，且其渲染逻辑明确读取并替换带
data-i18n的元素（例如用contenteditable包裹的 toolbar 容器） - 你在编辑器初始化后，手动遍历其生成的 DOM（如
.tox-toolbar__group、.ql-toolbar），对其中可见文本节点补加data-i18n并触发翻译函数 - 绝对不要给
<script>或<style>加data-i18n—— 它们不渲染为文本，加了无意义 - 编辑器弹出的 dialog、color picker、font selector 等浮层，DOM 是运行时插入的，需监听
DOMNodeInserted或用 MutationObserver 捕获后补标
第三方编辑器的 locale 切换实操要点
依赖编辑器自身能力比硬 Patch DOM 更可靠，但必须按文档要求时机操作：
立即学习“前端免费学习笔记（深入）”；
-
TinyMCE：必须在tinymce.init()前加载对应语言包（langs/zh_CN.js），并通过language: 'zh_CN'指定；运行时切换需tinymce.remove()后重新 init，否则无效 -
CKEditor 5：支持运行时切换，调用editor.locale.set('zh-CN')，但仅对后续创建的 UI 生效；已有 toolbar 需手动editor.ui.view.toolbar.element.remove()再重建 -
Quill：无原生多语言支持，所有按钮文案都得自己用 CSS 或 JS 替换；推荐在theme: 'snow'的toolbar配置中传入本地化字符串数组，如[['bold', 'italic'], [{ 'header': [1, 2, false] }]]→ 改成中文键名并映射 - 所有编辑器的
placeholder、title、aria-label属性都得单独处理，例如data-i18n-title="toolbar.bold"，不能只靠 textContent
容易被忽略的多语种标签陷阱
编辑器常嵌在复杂布局里，lang 属性错位会直接导致语音引擎误读、字体回退失效：
- 编辑器容器（如
<div id="editor">）必须显式设lang="zh-Hans"，不能只靠<html lang>继承——因为编辑器内容可能含英文代码块、URL、变量名，需局部声明lang="en" - 用户输入的富文本内容（
editor.root.innerHTML）里的<p>、<h2>等标签，若含夹杂外文，应保留原有lang，不能被全局切换覆盖；否则一段<p lang="ja">こんにちは</p>会被强行改成lang="zh-Hans"，语音引擎读成中文音 - 编辑器内部的
<pre lang="bash">、<code lang="js">必须保持原lang值，切换主语言时跳过这些节点，否则语法高亮和字体渲染全崩 - BCP 47 标准必须严格遵守：
zh-Hans可行，zh_CN或chinese在Intl和屏幕阅读器中大概率被忽略
