从Luckysheet到Univer:新一代开源在线表格引擎的架构与实践
先说结论:如果两年前有人问我“想在自家系统里塞一个在线表格,有没有开源方案”,我大概率会推荐 Luckysheet;但今天再问我同样的问题,我会先让他去看看 Univer。这不是否定 Luckysheet 的价值,而是 Univer 这个项目把“在线表格”这件事往上拉了一个维度。它是 Luckysheet 作者周辰慕和他的团队从 2021 年就开始打磨的新一代方案,目标不再只是“表格编辑器”,而是把文档、表格、幻灯片统一为一套基于 Canvas 渲染的协作办公引擎。用大白话说:你可以在自己的网站里,嵌入一个能多人实时编辑、支持公式、样式、合并单元格、图表,甚至以后还能扩展文档和 PPT 能力的组件。这篇文章毫无保留地分享我对 Univer 的拆解、接入过程和踩坑记录,给正在做在线编辑、协同办公、私有化部署选型的朋友一个参考。
1. 从 Luckysheet 到 Univer:不是升级,是重构
1.1 老一代方案的局限在哪
很多人对 Luckysheet 的印象是“一个好用开源的在线 Excel”。确实,它当年在渲染性能和交互体验上把不少老牌组件甩在了身后,社区讨论度一度很高。但真实业务一旦跑起来,它的短板也很明显。
最让我头疼的是扩展性。Luckysheet 的插件机制相对有限,想加一个自定义单元格类型或者深度介入编辑流程,得翻源码、改内部对象,维护成本非常高。其次是架构问题,Luckysheet 的代码是把“数据层”和“渲染层”耦合在一起的,数据格式也不够规范,导致多人在线协同这类高级能力很难优雅落地。我自己之前做过一次企业内部的报价单系统,想把 Luckysheet 嵌入 React 项目,虽然能用,但只要涉及复杂的权限控制、数据联动和二次开发,手里的牌就不够了。
这些痛点正是 Univer 诞生的背景。Univer 不满足于再做一个“更流畅的表格”,而是从底层架构上拆掉重建。它把数据、命令、渲染、交互分成独立模块,所有操作都通过 Command 模式驱动,底层状态树可序列化、可回溯,这就给协同编辑、撤销重做、公式链跟踪打下了很扎实的基础。可以说,这是拿面向大型复杂应用的思路来做编辑器,而不是拿“工具页面”的思路在做。
1.2 Univer 到底“重新定义”了什么
Univer 对外定位是多端协作办公套件,目前表格是主力,但架构里已经预留了文档(Docs)和幻灯片(Slides)的形态。打开 Univer 的仓库,你会看到它不是单一项目,而是由多个相互关联的包组成的 Monorepo 体系。核心的几个模块包括 @univerjs/core(数据模型与命令)、@univerjs/engine-render(底层渲染引擎)、@univerjs/sheets(表格核心业务)、@univerjs/sheets-ui(表格界面与交互)、@univerjs/ui(基础 UI 框架)等。
这种拆分的直接好处是:你可以只引入表格模块,然后在这个基础上二次开发;后续如果要加文档、幻灯片,基本是“插模块”而不是“换系统”。而且 Univer 渲染层用的是 Canvas,前端框架是 React、Vue、Angular 还是 Svelte 都不限制,因为它本身不依赖某一套组件库,这对我这种习惯在 React 里做复杂交互的人来说特别友好。
从实际体验来看,Univer 的操作逻辑非常接近 Excel 和 Google Sheets:支持右键菜单、拖拽填充、悬浮筛选、自动列宽、条件格式、公式自动补全,甚至图表和数据透视表也在持续完善中。我接入之后,如果不说,用户根本不会意识到这是嵌在网站里的一个开源组件,而不是 Excel 在线版。
2. 核心架构拆解:为什么 Univer 敢叫“引擎”
2.1 数据层与命令模式:一切皆可追溯
Univer 内部最核心的设计之一是 command 机制。可以简单地把它理解为:你在界面上做的每一个操作(输入字符、合并单元格、删除行),都会生成一个对应的 Command 对象,这个对象描述了“动作类型、作用目标、新状态、旧状态”。这条命令既会同步给当前文档的数据模型,也会被推入历史记录栈。
这种模式下,撤销(undo)和重做(redo)变得极其优雅,不需要像传统代码那样“反向执行操作”,而是直接从命令栈里取出旧状态覆盖回去。更关键的是,协同编辑里的“远程操作”本质上也是在不同客户端之间同步这些 Command,而不是同步最终结果。这个思路和 Google Wave、OT/CRDT 类算法的思路是一脉相承的,好处是数据一致性更容易保证,也方便审计。
我在做二次开发的时候,最直接感受到的价值是:想做一个“只允许改某些单元格”的权限控制,不需要去渲染层拦截鼠标事件,只需要在 Command 执行之前插入一个校验器,返回 false 就禁止操作。这种扩展路径非常干净,不侵入核心代码。
2.2 Render Engine 与 Canvas:性能和交互的平衡
Univer 的渲染引擎是独立的一层。它底层通过 Canvas 来绘制表格区域,同时允许局部重绘、按需渲染。相比 DOM 表格,Canvas 的优势在处理大数据量时非常明显:几百行、几十列的复杂表格,滚动和拖动时可以保持流畅,不会因为生成了大量 DOM 节点而卡死页面。
但 Canvas 也有难点,比如文本编辑、单元格选中、弹层定位都需要额外的数学计算。Univer 把这层封装好了,上层开发者基本不用关心坐标变换和视野裁剪。它还专门做了“高 DPI 适配”,在 Retina 屏幕上会自动用更精细的位图,同时缩放浏览器时,文档内容不会出现模糊。
我在做性能测试时,加载了一个两万行、二十列的测试表格(包含公式、格式、筛选),初次渲染大约不到两秒,滚动和编辑过程中的帧率稳定。这对于大多数业务场景完全够用。如果你接入的是千万级数据的“重型数据表”,那就需要做数据分片或者服务端聚合,Univer 本身并不负责把亿级数据一次灌入浏览器,它解决的是“数据进来之后的展示与交互效率”。
2.3 协同编辑与文档形态扩展
Univer 的协作能力建立在前面说的命令机制之上。每个端的修改都以命令为单位,通过服务端广播给其他客户端。接入方需要自己实现或者集成一套 WebSocket 服务端,Univer 提供了客户端侧的接收和应用机制。
不过有一点要提前说清楚:Univer 目前的协同能力和 OT/CRDT 完全成熟的方案(比如 Yjs)相比,还有一段路要走,尤其是冲突合并的“正确性”和边缘情况处理。如果是做轻量级的实时协作,比如几个人共同编辑一张销售表,那是能够稳定工作的;但要支撑几十上百人高强度并发编辑同一个文档,建议多做压力测试。未来 Univer 也在持续增强这一块。
另外,Univer 的 Docs 和 Slides 虽然目前还是早期阶段,但引擎层面的组件已经拆好,意味着后续你在同一套架构里同时用表格、文档、幻灯片时,不需要重新学习一套 API。我的判断是:现在入手 Univer,先专注表格没有问题;一旦后续文档模块成熟,你会省下非常大的迁移成本。
3. 实操过程:从零接入一个可编辑的 Univer 表格
3.1 环境准备与依赖安装
我假设你用的是 React 和 Vite,这是目前最主流的前端工程组合。新建项目后,只需要安装几个核心包。Univer 的 npm 包名称都以 @univerjs 开头,这也是判断第三方插件与核心版本兼容性的重要线索。
如果你还需要复制粘贴与更多交互能力,可以再加上 @univerjs/sheets-formula、@univerjs/sheets-numfmt 等模块。这里的版本号最好统一,避免混用不同版本导致内部类型对不上。
实际上我在初始接入时踩过一个坑:官方文档早期版本的初始化代码和最新版 API 略有不同,尤其是注册插件的方式。所以安装完依赖之后,最好对照当前版本的官方示例来写初始化代码,别直接用旧博客代码。
3.2 初始化一个最小可用的表格实例
Univer 的初始化分三步:创建 Univer 实例、注册所需插件、创建具体文档单元。下面是一段可以直接跑起来的代码,我用 TypeScript 来写,项目里的类型提示会更友好:
这段代码创建了一个空白的 Univer 应用,容器就是 #app 这个 DOM 节点。要让页面里真正出现一张表单,还需要手动创建一个工作簿实例,并写入基础数据:
用 createUniverSheet 之后就创建好了一个工作簿,sheet 里的 cellData 是二维映射,行和列都从 0 开始。打印一下 workbook.getActiveSheet() 就能拿到当前表单实例,后续 API 调用都基于这个实例。
3.3 使用 API 操作数据和样式
Univer 提供了丰富的数据操作接口。以常见的“设置单元格值”为例,可以通过 setCellValue 或更底层的 command API 实现。在业务代码中,我更推荐使用 command 方式,因为这样可以沿用撤销重做机制和权限拦截钩子。
这个封装看起来有点绕,但它体现的正是 Univer 的核心思想:操作不是直接改数据,而是通过命令去改。因为你永远不知道这个操作是来自本地用户、远程协同,还是 API 调用,只有统一走 command 通道,才能把并发冲突和权限判断放在同一道关卡里。
样式方面,可以用 setRangeStyle 来设置字体、背景色、对齐、边框等:
这里 horizontalAlignment 用数字 1 表示居中。如果你做过 Excel 的 COM 开发,对这种数字常量会很熟悉;Univer 在内部保持了一套类似 Office 的枚举体系,尽量让旧 Office 开发者可以平滑过渡。
3.4 在业务系统里嵌入与数据导入导出
在实际项目里,Univer 通常不是孤立页面的主角,而是嵌入到现有业务系统中的一个面板。常见做法是:主界面保留自己的操作区和导航栏,将 Univer 容器放在主内容区域,通过左侧或顶部工具栏对 Univer 实例进行操作。
Univer 原生 UI 自带完整的工具栏和菜单,在多数情况下直接使用即可。如果你希望收缩工具栏,只保留“纯表格区”的体验,也可以自己定制 SheetsUIPlugin 的配置项。有一个参数值得留意:container 指定承载组件;header 和 toolbar 是布尔值,控制是否显示顶部区域。通过这个配置,可以快速把 Univer 从“编辑器形态”切换成“视图形态”。
关于数据导入导出,Univer 提供导入 .xlsx、导出 .xlsx 的能力,但这一步需要引入额外的依赖和插件。我当时的做法是:首次加载时将后端传回的 JSON 数据直接写入 cellData,并将表格内容保存时通过命令数据序列化,再由服务端生成文件,从而规避了在前端做复杂二进制解析的成本。
不过,如果你确实需要用户上传一个 .xlsx 文件并在 Univer 中编辑、再导回到本地,建议你优先参考官方最新的导入导出插件实现,因为这类功能依赖的解析库版本和数组结构比较敏感,自己手写容易出乱码。
4. 进阶开发:公式、事件监听与二次封装
4.1 公式引擎的接入与使用
Univer 有一个独立公式引擎,官方仓库里实现了大量常用公式:SUM、AVERAGE、IF、VLOOKUP 等。在初次接入时,需要注册公式插件:
注册之后,直接在单元格里输入 =SUM(A1:B3) 或者 =IF(B2>100, "达标", "未达标"),它就会自动计算。公式计算是异步的,在数据量非常大时,Univer 会通过依赖树和缓存机制尽量减少重复计算。
不过要注意一个细节:公式引用的单元格如果被移动、插入行或删除行,Univer 会尝试自动调整引用关系,这个行为它在大部分常见场景下表现得很准。但如果你用了复杂的跨表引用,建议写自动化单元测试,确认公式引用不会因行删除而错乱。
4.2 通过事件监听获取用户操作
很多业务场景需要知道“用户刚才改了什么”。比如同步保存、操作日志、自动填充旁边字段等。Univer 内置了一套事件机制,可以在命令执行前后监听。
如果你只关注编辑类命令,可以在回调里过滤 command.type === CommandType.MUTATION 或 command.id。配合后端 WebSocket,就可以实现“每一次单元格改动都实时同步到服务端”,这是做在线协同和服务端备份的核心钩子。
另一种做法是注册一个自定义插件,在前置钩子里做权限控制。插件系统是 Univer 对外开放能力比较标准的方式,建议重点研究 beforeCommandExecute 和 afterCommandExecute 这两个生命周期阶段。在实际项目中,我用这个钩子实现了“指定工作表只读”,让业务用户只能编辑白名单区域,非常稳定。
4.3 将 Univer 封装为 Vue 组件
虽然 Univer 本身是用框架无关的架构设计的,但在项目里封装一个 Vue 组件会让使用更舒服。我用 Vue 3 做过一个封装组件,核心逻辑如下:
封装成组件之后,父组件可以通过 ref 获取 Univer 实例,然后调用 API 来设置数据或监听事件。这里的要点是容器 DOM 需要等到 onMounted 之后才能传入 Univer,否则渲染引擎找不到挂载点。
5. 常见问题排查与性能优化实录
5.1 初始化白屏:多半是容器尺寸问题
Univer 渲染依赖容器宽高,如果容器在初始化时尺寸为 0,比如在弹窗里打开表格,或者组件还没渲染完成,Univer 就会白屏或渲染报错。这是比较常见的问题。
解决办法是:在容器挂载并拿到确切宽高之后,再创建 Univer 实例。如果场景是“弹窗打开后,弹窗动画结束再加载编辑区”,建议延迟加载 Univer,或者在下一次 requestAnimationFrame 中创建。另外,给容器设置一个最小高度,比如 min-height: 400px,也可以避免一些奇怪的白屏。
5.2 渲染大表格卡顿:利用暂停渲染与分页策略
Univer 虽然用了 Canvas,但复杂表头、单元格合并、条件样式和公式引擎叠加时,仍会出现初始化卡顿。这里可以分治处理:
第一,如果一次性写入的数据很大,可以先关闭 UI 渲染,等数据全部写入后再打开,这样可以不用逐格重绘。可以通过配置项或者插件生命周期控制“开启渲染挂起”状态。第二,复杂样式不要一次性写全,比如后台返回一万行且每一行都有单独背景色,尽量先灌入纯数据,再通过小批量异步的方式设置样式,给浏览器喘息的机会。第三,如果数据实在太多,走服务端聚合,让前端只拿到当前可视范围数据。
5.3 协同编辑中产生的编辑冲突
在多人同时编辑同一格或者进行“删除行 + 插入行”交错操作时,有可能出现状态不一致。Univer 的协同机制还在快速迭代中,我在实际测试中最稳妥的策略是:客户端收到远端命令时,先检查当前版本号与服务端版本是否一致,不一致则拉取最新快照后重放本地操作。
如果你使用的是官方推荐的后端同步方案,那一般没问题;如果你是自己写 WebSocket 服务,建议在客户端的命令发送队列里用“发送前锁定 + 收到 ack 后解锁”的方式,避免在连接抖动的情况下重复发送同一命令。
这里我还想多提一句:Univer 官方服务端(Univer Server)提供了一定的协同能力,但目前它的功能边界和历史稳定性要比商业产品(比如 ONLYOFFICE 协作服务器)收敛一些。建议把 Univer 当作“前端体验层”,将核心数据状态和权限服务放在自己的后端,更稳妥。
5.4 实用性能优化清单
我整理了一份自己在项目里验证过的优化点,包含禁用不必要插件、按需加载语言包、控制刷新频率、避免频繁 setCellValue 等。表格按需加载的核心 API 是动态 import(),对于初加载体积较大的项目,建议做好拆包和压缩。
| 场景 | 问题 | 优化方案 |
|---|---|---|
| 初次加载体积大 | 所有插件都打包 | 使用动态导入,按需注册依赖 |
| 表格初始化慢 | 数据过大、样式过多 | 分批写入数据,先可视化数据再设置格式 |
| 编辑卡顿 | 未限制重绘频率 | 使用请求动画帧节流,聚合短期修改 |
| 协同冲突 | 版本号未校验 | 服务端维护版本号,客户端冲突时拉取快照 |
| 预览表格样式 | 误开启完整编辑态 | 关闭 headers 和 toolbar,展示纯表格视图 |
6. 选型建议与生态观察
如果做一个严格的表格组件选型,市面上可比的方案无非三类:自研(用 Web Component 或 React 手写)、购买商业控件(比如 SpreadJS、Handsontable 企业版)、用开源组件做二次封装(Univer、Luckysheet、x-spreadsheet)。
自研的成本很高,尤其涉及公式解析、打印、格式化这些深水区时,不是几周就能完成的。商用控件胜在稳定和售后,缺点是需要授权费用,且闭源,扩展能力完全取决于厂商。开源的几个项目里,x-spreadsheet 功能较为基础,Luckysheet 社区活跃度下降,Univer 是我目前看到的扩展性和现代化程度最好的。
Univer 的优势在于:模块是独立的,数据层干净,渲染层强大,社区有新功能持续迭代。但同时,它的文档和示例还有不少待完善的地方,API 也存在从旧版到新版的变化。如果想在一个高流量的生产系统里直接上 Univer,需要你的团队有足够的 TypeScript 功底和前端架构能力,能在它的基础上做二次封装和兜底方案。
我在项目中的最终选型是:Univer 作为在线表格编辑核心,服务端存 JSON 格式源数据,导出时通过后端转换生成 .xlsx。这种组合既保证了前端编辑体验,又不会把解析 Office 文件的压力拉满到浏览器。如果你的业务核心就是“让多个同事同时在线维护一张业务表,并保存历史版本”,Univer 是一个值得投入的开源方案。
7. 最后说点个人体会
把 Univer 接入生产环境,不是“加一个组件”那么简单,它更像是在你自己的系统里,亲手搭建了一个小型办公平台的地基。前前后后我踩了很多坑,也写了不少辅助代码,但运行稳定之后,那种“用开源工具拼出业务闭环”的感觉是挺过瘾的。
如果你现在正处在方案选型阶段,我的建议是:先用官方 Demo 跑一遍交互,再拿自己的典型业务表格测试性能和边缘操作,最后再去深究扩展机制。Univer 的路还很长,但它已经足够优秀,也值得被更多中文开发者认识和贡献。希望这篇文章能给你省下一些自己踩坑的时间,也欢迎有类似实践的朋友一起交流。