contenteditable 是开箱即用但极易翻车的属性，仅提供可编辑底层能力，存在浏览器兼容性差、默认插入冗余html、粘贴xss风险、换行语义混乱、选区异常及事件监听缺失等问题，需严格约束与清洗方可安全使用。
contenteditable 是个“开箱即用但极易翻车”的属性——它能让任意元素变成可编辑区域，但默认行为几乎无法直接用于生产环境。
为什么 contenteditable="true" 一加就出问题
浏览器对 contenteditable 的实现差异大，且默认会插入冗余 HTML（比如 <div> 换行、<code><span></span> 样式残留、光标跳转异常），尤其在 Safari 和旧版 Edge 中更明显。它不是富文本编辑器，只是“让内容可编辑”的底层开关。
- 粘贴时会带入源格式（甚至 script 标签），不清洗直接存库可能引发 XSS
- 回车键在不同浏览器中生成
<div>、<code><p></p>或<br>，语义混乱 - 选区操作（如全选、删除）在嵌套元素里容易丢失焦点或破坏结构
- 不监听
input事件（它只触发blur和keydown），需用MutationObserver或input的变通监听 - 禁止格式化粘贴：设置
execCommand('insertText', false, text)替代原生粘贴（注意execCommand已废弃，仅作兼容过渡） - 限制可编辑区域边界：对父容器设
user-select: none，子元素中仅允许特定标签（如<span></span>、<strong></strong>）响应编辑，其余设contenteditable="false" - 禁用默认换行行为：监听
keydown，对Enter调用event.preventDefault()，再手动插入<br>或自定义分隔符
如何安全启用并限制编辑范围
避免直接给 <div contenteditable="true"> 加样式或逻辑，先做最小化约束：
<ul>
<li>用 <code>contenteditable="plaintext-only"（Chrome 121+ 支持）或降级为 contenteditable="true" + onpaste 清洗：拦截 paste 事件，用 event.clipboardData.getData('text/plain') 提取纯文本
contenteditable 与 designMode、document.execCommand 的关系
三者属于同一套过时 API 体系：designMode = 'on' 作用于整个 iframe 文档，contenteditable 是其粒度更细的替代；而 execCommand 是配套的命令执行接口（如加粗、缩进）。它们共同的问题是：
- 无标准化输出格式，
document.execCommand('bold')在不同浏览器中可能包裹<b></b>、<strong></strong>或内联 style - Chrome 98+ 已移除部分命令支持，Firefox 也标记为 deprecated
- 现代方案应转向
Selection+RangeAPI 手动操作 DOM，或使用getSelection().getRangeAt(0)获取当前选区再修改
真正可用的轻量级替代思路
如果目标只是“让用户改一段文字”，别硬刚 contenteditable ——优先考虑：
- 用
<input type="text">或<textarea></textarea>+ 自定义 focus/blur 样式模拟“内联编辑”，语义清晰、事件可控、无障碍友好 - 需要多段落或简单格式？用
contenteditable但只读取textContent，忽略所有 HTML 结构，后端按纯文本处理 - 真要保留格式？引入
prosemirror或slate这类现代编辑器框架，它们内部已封装了contenteditable的坑，而不是在它上面叠补丁
最常被忽略的一点：contenteditable 元素的 innerHTML 不等于用户看到的内容——DOM 树里可能藏着不可见的 <span data-uuid="xxx"></span>、空 <div></div> 或浏览器自动插入的零宽字符。每次读取前必须 normalize 或 sanitize，不能直接当结构化数据用。
