HTML history API 仅管理 URL 和轻量 state，不支持自动回溯表单、编辑器等状态；popstate 需早期监听、同源 URL、state 必含可还原的最小数据集（非 DOM/函数），且需原生 API 还原 DOM 与交互。
HTML 历史记录（window.history）本身不支持操作回溯，这不是 bug，是设计使然——它只管 URL 跳转和轻量 state，不管表单输入、编辑器光标、DOM 变更这些。
pushState 存了 state 但 popstate 拿不到？检查三个硬性前提
常见错误现象：popstate 事件根本没触发，或 event.state 是 null。
- 监听必须在页面加载早期注册（比如
DOMContentLoaded阶段），不能等 React 组件挂载完才加——popstate不重放，错过就没了 -
pushState的第三个参数（URL）必须是同源的，file://协议下整个 API 静默失效，连错误都不抛 - 用户手动刷新或从地址栏进入页面时，
history.state永远为null；别指望它能“自动继承”上一次的状态
想用 history 实现版本回溯，state 里必须塞什么
不是存个时间戳或版本号就够了。还原页面 ≠ 改个 URL，而是要让内容真正回到那个状态。
- state 必须包含可完整还原渲染所需的最小数据集：比如编辑器的组件 JSON（
editor.getComponents().toJSON()）、当前选中字段名、滚动位置（window.scrollY） - 绝对不要存 DOM 节点、函数、
document或window引用——JSON.stringify()会直接丢掉它们，还原时变成undefined - 避免存整页 HTML 字符串（
document.documentElement.outerHTML）：体积大、序列化慢、易超浏览器限制（多数浏览器对state大小限制在 640KB 内）
popstate 触发后，DOM 还原为什么交互全失效
因为直接操作 innerHTML 或 document.write() 会销毁已绑定的事件监听器、清空 Web Component 实例、卸载富文本编辑器 runtime。
Wechat Article Html
下载
将 Markdown 文章转换为微信公众号兼容的纯 HTML 格式。当用户要求"转成微信格式"、"生成公众号文章 HTML"、"排版到微信草稿箱"、"微信粘贴格式"时触发。输出带内联样式的纯 HTML，微信编辑器可直接渲染，无需额外适配。支持标题、段落、列表、粗体、行内代码、表格、引用块、代码块、配图的完整转换。
立即学习“前端免费学习笔记（深入）”；
- 可视化编辑器（如 GrapesJS）必须调用其原生 API 还原：
editor.setComponents(json)+editor.setStyle(css) - 若预览区用
iframe隔离，还原时得用iframe.contentDocument.write(html)，再重新注入脚本（否则按钮点击无响应） - 跨域
iframe无法通信，此时popstate必须降级为全页跳转，不能尝试 message 通信
history API 和 undo/redo 栈必须物理隔离
把每次输入都 pushState，历史栈会迅速膨胀，用户点“后退”会退回上一步文字修改，而不是上一个页面——这既反直觉，又破坏 SPA 导航语义。
- undo/redo 必须用纯内存栈实现（如
undoStack = []），不依赖history.state -
popstate回调里只做一件事：根据event.state.versionId从localStorage加载快照，再交由业务逻辑重渲染 - 自动保存场景下，用
replaceState更新当前条目，避免新增历史项污染后退链
最容易被忽略的一点：history API 不保存任何东西到磁盘或服务端，也不跨标签页同步。你关掉这个 tab，所有 state 就彻底消失——真要持久化，得自己写 localStorage.setItem('version-v123', JSON.stringify(state))。
