为什么 Office 在线预览这么难做好
把 PDF 和图片放到网页上很简单，但 Office 文档是另一回事。docx、xlsx、pptx 本质上是一堆 XML 加资源的压缩包，里面记录的不只是「内容」，还有完整的排版规则：分页位置、字体度量、行距字距、浮动对象、表格嵌套、公式排版、动画时间轴。
想把它还原出来，等于要在浏览器或服务端重新实现一遍 Office 的排版引擎。这就是为什么市面上的方案看起来五花八门，实际能力差距却非常大——差别不在功能列表，而在渲染引擎放在哪里、由谁实现。
七种方案，其实只有三条路
把目前能找到的 Office 在线预览方案列出来，大致有七种。但它们的技术底色只有三条：服务端解析、商业云服务、浏览器前端解析。
| 路线 | 代表方案 | 核心思路 | 天花板 |
|---|---|---|---|
| 开源自建 | kkFileView、LibreOffice / OpenOffice 转换 | 服务端调用转换组件，转成 PDF/HTML 再展示 | 还原度受组件限制，高并发需自行扩容 |
| 商业服务 | WPS 365、嵌入式预览插件 | 厂商提供成熟引擎，按订阅或按量计费 | 成本随规模增长，数据在厂商侧 |
| 浏览器前端 | xlsx.js 等前端组件、Google / Office Online | 把文件下载到浏览器，前端自行解析渲染 | 复杂版式、动画、公式基本无法还原 |
逐个拆解：七种方案的强项与天花板
1. kkFileView（开源自建）
国内知名度最高的开源预览项目，基于 Spring Boot，底层调用 LibreOffice 做格式转换，再输出 PDF 或图片给前端。
- 优势：免费、社区活跃、格式覆盖面在开源项目里算广，部署文档齐全。
- 天花板：转换依赖 LibreOffice，字体替换会导致分页偏移；PPT 动画、Excel 图表与公式还原有限；CAD 支持弱；高并发时转换任务排队，需要自行做队列与扩容。
2. LibreOffice / OpenOffice 自建转换服务
很多团队自研的第一条路：装一个 LibreOffice，写脚本转 PDF，再把 PDF 丢给前端。
- 优势：完全自主可控，不依赖外部服务。
- 天花板：Office 与 LibreOffice 是两套排版引擎，复杂公文、财务报表、招投标文件容易出现版式偏移；需要自己维护转换队列、监控与僵尸任务清理；后续每次格式兼容问题都要自己填坑。
3. WPS 365 / 金山文档（商业服务）
商业闭源方案，格式覆盖与还原度都不错，也支持 OFD。
- 优势：还原度接近原生，生态完整，支持 OFD 与信创。
- 天花板：按账号或订阅计费，规模化后成本上升；私有化部署门槛与费用较高；CAD 图纸不在其能力范围。
4. xlsx.js 等纯前端解析方案（浏览器前端）
把文件下载到浏览器，用 JavaScript 解析 OOXML 后自行排版。
- 优势：零服务端成本，部署极轻，文件不出浏览器。
- 天花板：它要在浏览器里重新实现排版引擎，分页、页眉页脚、浮动图片、文本框、复杂表格都难以精确还原；PPT 动画、Excel 公式结果、CAD 与 OFD 基本不支持。
5. Google Docs Viewer / Microsoft Office Online（免费在线服务）
输入一个公网可访问的文件地址，由外部服务渲染后嵌入页面。
- 优势：零成本、零部署，几行代码即可接入。
- 天花板：文件必须公网可访问，等于把原始文件暴露给第三方服务；国内访问稳定性差；不支持 OFD、CAD，也无法私有化，涉密与合规场景直接出局。
6. 本地 Office / WPS 组件调用（终端依赖）
在终端或服务器上调用已安装的 Office、WPS 组件完成渲染。
- 优势：还原效果最接近原生。
- 天花板：每一台终端都要满足环境要求，交付与售后成本随用户数线性增长；信创环境、内网统一交付、容器化部署都很别扭。
7. 按次计费的嵌入式预览插件（商业 SaaS）
以 SDK 或 iframe 形式嵌入，按调用次数或流量计费。
- 优势：接入极快，无需运维。
- 天花板：成本随调用量线性上升，长期看不一定便宜；数据经过第三方；能力边界由厂商定义，难以深度定制。
能力矩阵：一张图看清差距
把七种代表性方案放进同一张表，按八个维度打分。绿色是完整支持，黄色是部分支持，灰色是不支持。
几个值得注意的结论：
- PPT 动画几乎全军覆没：除 USDOC 外，所有方案都把 PPT 转成静态页面，动画、触发器、音视频全部丢失。
- OFD 是分水岭：只有 WPS 365 与 USDOC 支持，其余方案在信创公文场景直接出局。
- CAD 几乎无人覆盖：dwg / dxf 是工程行业的刚需，但主流预览方案基本不碰。
- Excel 公式存在普遍缺口：纯前端方案无法计算结果，开源方案取决于转换组件的实现程度。
USDOC 的六个差异化优势
USDOC 文档在线预览做的事情和上面这些方案有重叠，但定位更聚焦：把「还原度」和「落地能力」同时做到位。
优势一：Office 原生还原 —— 动画、触发器、音视频
这是与其他方案差距最大的一项。USDOC 不做「转成静态图片」的事，而是按原始时间轴播放 PPT 动画：
- 原生动画 1:1 还原：进入、强调、退出动画按原始时间轴与触发顺序逐步播放，顺序与 PowerPoint 一致。
- 原生触发器：点击对象触发指定动画，课件与交互式演示的触发逻辑完整保留。
- 音视频放映：演示文稿内嵌的音频与视频可直接在线播放。
- 在线画板：放映时可用画笔、荧光笔、激光笔直接圈画标注，支持撤销与清除。
优势二：自研公式引擎与文字排版引擎
公式和排版是 Word 最容易「露馅」的地方，也是大多数方案降级处理的部分。
- PPT 公式引擎：分式、上下标、积分、求和、矩阵、根式等复杂公式矢量排版，放大后依然锐利，而不是截图。
- 文字排版引擎：精确控制字距、行高与基线对齐，中文与西文混排自动匹配字宽与标点间距，长段落换行位置稳定。
- Excel 公式引擎：解析公式并按单元格引用计算结果，选中单元格时可在公式栏查看原始公式并高亮引用区域。
优势三：CAD 与 OFD —— 别人不做或做不好的两件事
这两类格式是工程与政务场景的刚需，但恰好是通用预览方案的能力盲区。
- CAD 图纸预览：DWG / DXF 浏览器直接打开，支持无极缩放、图层控制与尺寸标注还原，矢量渲染放大不模糊。
- OFD 版式文件：无需先转 PDF，签章、页码与版式按原文件还原，支持按页加载，几百页档案也能快速打开。
优势四：60+ 种格式，单文件最大 2GB
同一套预览地址通吃 Office、PDF、OFD、CAD、图片与 ZIP 压缩包，业务系统不必为不同格式写多个分支。企业版单文件支持到 2GB，配合异步切片解析与分级加载，2GB 的工程图纸也能在几秒内出轮廓。
优势五：零插件与毫秒级解析
- 纯 HTML5 渲染：不依赖 Office 组件、ActiveX 或任何浏览器插件，终端不需要安装任何软件。
- 服务端解析：解析与排版在服务端完成，浏览器只负责渲染，老旧电脑与手机同样流畅。
- 接入极简：拼接一个 URL 放进 iframe 即可，不需要 SDK、不需要维护转换队列。
优势六：私有化、永久授权与信创适配
- 私有化部署：服务部署在企业内网，文件全程不出企业边界。
- 永久授权：一次部署长期使用，不按调用量计费，规模化后成本优势明显。
- 信创适配：支持鲲鹏、飞腾、龙芯、海光、兆芯等国产 CPU，适配麒麟、统信 UOS、中科方德等国产操作系统，提供离线安装包与离线授权。
按场景选型：不是所有项目都要用最重的方案
客观地说，并不是所有项目都需要 USDOC。按场景选型比按产品选型更省事。
| 场景 | 核心诉求 | 推荐方案 |
|---|---|---|
| 只预览 PDF / 图片，内部工具 | 轻量、零成本 | 纯前端方案即可 |
| 需要多人协同编辑文档 | 编辑与协同能力 | WPS 365 |
| 公文 OFD、工程图纸、信创内网 | 版式还原 + 私有化 | USDOC 文档在线预览 |
| 复杂 Office 还原（动画 / 公式 / 图表） | 高保真还原 | USDOC 文档在线预览 |
| 培训课件、产品演示 | PPT 动画与音视频 | USDOC 文档在线预览 |
最终对比：三个维度看清差异
| 对比维度 | 开源自建方案 | 商业云服务 | 浏览器前端 | USDOC |
|---|---|---|---|---|
| Office 还原度 | 取决于 LibreOffice | 较好 | 复杂版式易偏移 | 按原文件版式还原 |
| PPT 动画 / 触发器 | 不支持 | 通常转静态页 | 不支持 | 1:1 按时间轴播放 |
| OFD / CAD | 基本不支持 | 部分支持 OFD | 不支持 | 两者均完整支持 |
| 部署形态 | 自建自维护 | 以云端为主 | 零部署 | SaaS 与私有化均可 |
| 成本结构 | 人力成本为主 | 按订阅 / 调用量 | 几乎为零 | 永久授权，不按量计费 |
| 信创适配 | 需自行验证 | 视厂商而定 | 受浏览器限制 | 国产 CPU 与系统适配 |
| 数据安全 | 自主可控 | 数据在厂商侧 | 文件不出浏览器 | 内网私有化，不外流 |
常见问题
kkFileView 和 USDOC 的主要差别是什么？
kkFileView 是开源自建方案，底层依赖 LibreOffice 转换，免费但需要自己维护服务与转换队列，PPT 动画、CAD、OFD 支持有限；USDOC 是服务端解析渲染的商业方案，还原度更高、格式覆盖更广，并提供私有化部署与永久授权。
USDOC 支持在线编辑吗？
USDOC 聚焦在线预览，不提供文档编辑能力。如果业务需要多人协同编辑，建议搭配 WPS 365 等具备编辑能力的方案，用 USDOC 承担高保真预览环节。
PPT 动画真的能 1:1 还原吗？
可以。USDOC 按演示文稿记录的时间轴与触发顺序逐步播放动画，进入、强调、退出动画与触发器均按原始设定执行，音视频也能直接在线播放。
私有化部署后还需要按调用量付费吗？
不需要。私有化部署提供永久授权方式，一次部署长期使用，不按预览次数计费，规模越大成本优势越明显。
信创环境（国产 CPU / 操作系统）能部署吗？
可以。支持鲲鹏、飞腾、龙芯、海光、兆芯等国产 CPU，适配麒麟、统信 UOS、中科方德等国产操作系统，并提供离线安装包与离线授权。
文件最大支持多大？
企业版单文件最大支持 2GB。配合异步切片解析与分级加载，大文件先返回整体轮廓再按需补充细节，不会出现长时间白屏。
小结：选方案就是选能力边界
Office 在线预览看起来是一个功能点，实际是一条完整的技术链路。七种方案背后的差别，说白了就是三件事：渲染引擎放在哪里、由谁实现、能不能落到你的部署环境里。
如果你的场景只需要看 PDF 和图片，纯前端方案足够；如果需要协同编辑，选 WPS 365；但如果你的业务里有 PPT 动画、复杂公式、Excel 图表、CAD 图纸或 OFD 公文，同时还要满足信创与私有化要求，那么可选范围其实很窄。
