故障排查

编辑器保存很慢、字体加载不出来、打开很卡怎么办

更新于 2026年7月1日

保存慢通常是网络波动所致，编辑器会自动重试；字体加载不出来多为网络访问 font.im 受阻，可刷新页面重试或换用系统字体；打开很卡可检查页面元素数量并关闭其他浏览器标签。

编辑器状态条若显示「保存中…」或「未保存」，说明本地修改尚未落库；字体渲染不正常通常是字体文件未下载完；操作卡顿与当前页面元素数量和浏览器负载相关。以下按三类现象分别排查。

一、保存很慢 / 状态一直显示「未保存」

现象

  • 工具栏状态条长时间显示「未保存」或「保存中…」。
  • 手动点击「保存」按钮或按 Ctrl+S（Mac：Cmd+S）后，转圈超过数秒未完成。

可能原因

  1. 网络波动：自动保存通过 HTTP 请求发送到后端，网络抖动会导致请求耗时增加甚至失败。
  2. 自动保存防抖延迟：编辑器在停止编辑后才触发保存（V2 编辑器防抖窗口为 30 秒），持续编辑时状态显示「未保存」属正常——最晚在距本批首次修改 30 秒内必定发送一次保存请求。
  3. 并发阻断：一次保存请求正在飞行中时，新的保存会等待上一次完成后再发出，状态栏持续显示「保存中…」是正常保护行为。
  4. 登录态失效：token 过期会触发自动刷新并重试，极少数情况下重试仍失败会弹出错误提示。

检查步骤

  1. 查看浏览器右下角或状态栏是否有红色错误提示「网络连接失败」——有则为网络问题。
  2. 打开浏览器开发者工具（F12） → Network 面板，过滤 auto-save，观察请求状态码：
    • 200：保存成功，若状态条仍显示「未保存」可刷新页面。
    • 401：登录态失效，刷新页面重新登录。
    • 5xx：服务端错误，稍后重试。
    • 请求长时间 pending：网络或服务器响应慢。
  3. 确认自己仍处于登录状态（Dashboard 页面能正常加载）。

解决方案

  • 手动强制保存：按 Ctrl+S（Mac：Cmd+S）立即触发保存，无需等待自动保存防抖。
  • 网络问题：切换到更稳定的网络环境，或等网络恢复后再操作。
  • 刷新页面：刷新前确认最近的修改已保存（状态条显示「已保存」），刷新后编辑器会重新从服务端加载。
  • 持续无法保存：记录错误截图（含 Network 面板），联系翻页宝支持。

二、字体加载不出来 / 显示方块或乱码

现象

  • 文字元素显示方块（□□□）或被替换为其他字体，不是设置的那个字体。
  • 切换字体后预览不变，或预览区仍显示默认字体。
  • 右侧属性面板字体选择器中字体名称正常，但画布上渲染错误。

可能原因

  1. 字体文件下载受阻：翻页宝内置字体通过 fonts.font.im 镜像服务下载。该服务在某些企业网络、VPN 或特殊网络环境下可能被屏蔽或超慢。每个字体最多等待 8 秒，超时后使用系统后备字体。
  2. 自定义字体访问链接过期：上传的自定义字体使用临时授权链接（有效期约 55 分钟），长时间打开同一页面后链接失效，字体需重新加载。
  3. 网络缓存不一致：浏览器内存中字体已加载，但实际文件损坏，强制刷新可修复。

检查步骤

  1. 打开浏览器开发者工具（F12） → Network 面板，过滤 font.im 或 .woff，观察字体请求是否有 failed 或 blocked 状态。
  2. 如是自定义字体：查看 Network 中字体请求是否返回 403（链接过期），刷新页面可重新获取链接。
  3. 确认字体仅影响编辑器展示还是同时影响阅读器——如阅读器也有问题，参见「发布后字体显示异常」排查。

解决方案

  • 刷新页面：大多数字体加载问题通过刷新页面解决。编辑器会在打开时重新按需加载当前作品所用的字体。
  • 改用系统字体或其他内置字体：若特定字体持续无法加载，可临时换用翻页宝其他内置字体（如「Noto Sans SC」「Noto Serif SC」）。
  • 检查网络环境：若在企业内网、使用 VPN 或特殊代理，可能需要将 fonts.font.im 加入访问白名单，或切换至移动热点测试。
  • 自定义字体：若上传的自定义字体无法加载，前往「字体管理」重新确认文件格式是否为 TTF、OTF 或 WOFF/WOFF2，损坏的字体文件需重新上传。

三、编辑器打开很卡 / 操作响应慢

现象

  • 拖拽元素时画面明显滞后，帧率很低。
  • 单页元素数量较多（如包含数十个图片、文字、特效元素）时尤为明显。
  • 浏览器 CPU/内存占用高，系统风扇转速明显。

可能原因

  1. 当前页面元素过多：翻页宝编辑器在单页元素数量较多时，渲染负担增加，操作响应会变慢。
  2. 浏览器标签占用资源：同时开启多个网页标签，占用内存和 CPU，影响编辑器性能。
  3. 流畅模式未启用：V1 编辑器支持流畅模式（auto/on/off 三档），元素数量较多时流畅模式会简化部分阴影渲染来提升帧率。

检查步骤

  1. 观察状态栏底部是否提示「流畅模式」已自动开启（V1 编辑器，当前页元素数量 ≥ 50 时自动激活）。
  2. 关闭不必要的浏览器标签和后台程序，腾出系统内存。
  3. 打开浏览器任务管理器（Chrome：Shift+Esc），确认翻页宝编辑器标签的内存和 CPU 占用情况。

解决方案

  • 减少单页元素数量：将内容分散到多个页面，避免单页堆积过多元素。
  • 合并或替换静态图层：把多个装饰图形合并为一张背景图片，可显著减少元素渲染数量。
  • 关闭其他标签：释放浏览器内存，有助于改善编辑器渲染流畅度。
  • 使用流畅模式（V1 编辑器）：工具栏「更多」菜单中可手动切换流畅模式为「开」，强制启用简化渲染，降低 CPU 负担。