Univer深度拆解:开源表格基础设施的渲染、公式与协同实践
“开源版 Google Sheets”这个名头,这两年陆续见过不少类似项目,但真正让我觉得“这玩意儿能拿来干活”的,还是 univer。如果你在 GitHub 上刷到过它,大概率会看到一句很有意思的 Slogan:Build spreadsheets like building websites,像构建网站一样构建电子表格。这句话翻译一下其实是——我今天不给你一个锁死的表格文件,我给你一把能造表格的“脚手架”。
入门第一周,我的最大感受是:这不是一个单纯的“表格控件”,而是一整套表格基础设施。它不仅能渲染单元格、跑公式,还内置了协同编辑、样式系统、跨端适配和极其夸张的插件生态。对前端工程师来说,它像一套 React;对产品经理来说,它是一个可以贴进自家 SaaS 业务里的“在线 Excel”;对独立开发者来说,它可能是把复杂表格需求从“外包定制”变成“npm install”的关键一步。
这篇分享我不会停留在项目介绍层面,而是会结合我实际接入和二次开发的过程,把这东西的架构思路、关键模块、部署姿势和踩坑实录都拆开讲。项目还在快速迭代,我不打算写一份会过时的 API 手册,而是把“为什么这么设计”“你在什么场景下比较适合上它”以及“真正跑起来会踩哪些坑”讲透。
1. 核心背景与技术定位
1.1 表格基础设施到底是什么?它解决什么问题
前几年如果你想在网页里做表格编辑,无非三类路子:
- 基于 DOM 的表格,比如原生的
<table>配合 contenteditable,或者套一层 Handsontable 这类封装; - 纯 JS 数据解析方案,比如 SheetJS,它能读 Excel 文件,但交互编辑能力要靠自己补;
- 自研 Canvas 引擎,比如 Google Sheets、飞书表格,性能和体验最好,但开发成本极高。
univer 走的是第三条路,但它把成本“开源”了。它自研了一套基于 Canvas 的渲染引擎,一套独立于 UI 层的公式引擎,外加一套支持多人实时协同的架构框架。从表面上看,它是一款在线电子表格产品,但实际上它更像是一个“搭表格产品的工具集”。
这里要特别强调一个容易误解的点:univer 不是拿来读 xlsx 的库,也不是一个现成表格网站,它是一堆积木。你装配出来的东西,可以被嵌入你的后台管理系统、低代码平台甚至移动端 H5。换句话说,它的核心价值不是“帮你做一个表格”,而是“让你的产品拥有表格能力”。
1.2 什么人、什么场景适合关注 univer
先说结论,再解释为什么。
| 目标人群 | 典型场景 | 关注理由 |
|---|---|---|
| SaaS 产品研发 | 财务、项目管理、HR 模块内的数据录入 | 比自研划算,比 iframe 集成体验好 |
| 低代码平台团队 | 需要内置数据表组件 | 插件架构天然支持定制 UI 和公式行为 |
| 数据密集型业务 | 报表分析、运营看板、库存管理 | 百万级单元格渲染不掉帧 |
| 独立开发者 | 快速给项目加一个多人协作表格 | 一套代码跑桌面端和 Web |
我自己是给一个企业内部的运营中台做报表模块时接触到它的。当时的需求是“让业务人员像用 Excel 一样录入和查看数据,还要支持多人同时编辑”。如果纯自研,从渲染引擎开始搭,差不多要两个季度;用 univer 做底座,两周就出了可交互原型。
当然,它也不是万能的。如果你要做的只是“解析 Excel 文件里的数据然后画个图表”,那不需要上 univer,SheetJS 就绰绰有余。univer 的最佳使用场景是有“交互式编辑”和“在线协作”需求的业务系统。
2. 技术架构深度拆解
2.1 渲染层:为什么一定选 Canvas,而不是 DOM
这是整个架构里面最值得琢磨的一个决策。
早期的在线表格,比如老版本的 Office Web,用的其实是 DOM 渲染。每个单元格都是一个真实的 HTML 元素。这么做的好处是开发简单、浏览器兼容性好、复制粘贴天然支持,坏处是当表格规模变大时,DOM 节点数量会爆炸。一个 100x100 的表格就是一万个节点,再往上走,页面直接卡死。
univer 选择了 Canvas 渲染,整个工作表是画在一张 canvas 上的,单元格不是真实 DOM,而是由渲染引擎按可视区域动态绘制出来的。这个思路和游戏引擎很像:你看到的永远只是“视口”内的东西,滚动的时候重新绘制,而不是把所有节点都挂在页面上。
实际测试下来,10 万行数据的基本滚动交互,帧率维持在 60 帧没有明显压力。和 DOM 方案拉开差距的关键还不是帧率,而是内存占用。DOM 方案随着数据量增长内存几乎线性上涨,Canvas 方案则稳定得多。
当然 Canvas 也带来了代价:文字选择、输入法、系统剪贴板这些“本来浏览器帮忙做的事”,都需要引擎自己实现。univer 在文本输入这块做了大量底层工作,包括对 Windows 上中文输入法的兼容处理,这里面的复杂度很多人是体会不到的。
2.2 计算层:一套独立公式引擎的设计哲学
很多前端表格方案对公式的处理是“假公式”,要么在数据变更时重新解析整个公式串,要么干脆只支持加减乘除。univer 则编译了一套真正的公式引擎,类似 Excel 的计算链机制。
这套引擎的用途不只是算 =SUM(A1:A10) 这种基础表达式,它内置了 400+ 函数,涵盖财务、统计、逻辑、文本处理等类别,还支持自定义函数。你甚至可以注册一个 JavaScript 函数,让它像原生函数一样出现在公式里。
公式引擎的另一个关键能力是“脏单元格追踪”。在一个大表格里,如果你改了 B2 单元格,而 C5 的公式依赖 B2,D6 又依赖 C5,univer 不会傻乎乎地全表重算,而是沿着依赖链只重算受影响的部分。这个设计直接影响大数据量下的编辑响应速度。
这里我得吐槽一句,目前自定义函数的开发体验还有优化空间,文档不够细,调试报错信息也比较抽象,很多时候要靠 console 手动打印排查。但好在它把接口暴露得很干净,你用业务代码包一层也不难。
2.3 协同层:多人同时编辑怎么保证不打架
在线表格的协同和在线文档还不太一样。文档是线性排版的,冲突主要发生在段落级别;表格是二维结构,一个用户改 A1,另一个用户同时在改 A1,怎么合并?
univer 没有从零造一套 CRDT(无冲突复制数据类型),而是设计了一个协同适配层,支持接入 Yjs、Sharedb 等多种协同算法。这种做法的聪明之处在于,算法可以按业务场景替换:本地小规模协作用 Yjs 足够,跨地域大规模协作可以换成 OT(操作转换)方案。
从接入视角看,univer 把“实时协同”封装成了增量消息流:每个用户的编辑操作会被转换成不可变的操作指令,发送到协作服务端,再广播给其他客户端。这个思路和 Figma 很像,底层不是传“最终的表格状态”,而是传“操作 Diff”。
如果你是自建协同服务,建议先明确自己的业务对一致性要求有多高。如果只是几十个人同时编辑一张报表,Yjs 的简单模型就够了;如果有比较强的权限和审批流需求,你可能还要在协同协议之上再包一层业务规则。
2.4 插件化架构:像搭积木一样扩展功能
这一点是我个人认为 univer 做得最“现代化”的地方。整个项目在包结构上不是一大坨,而是按职责拆成了很多小包,典型的如:
@univerjs/sheets:电子表格核心数据模型@univerjs/engine-render:Canvas 渲染引擎@univerjs/engine-formula:公式引擎@univerjs/engine-numfmt:数字格式引擎@univerjs/ui:UI 层(菜单、工具栏、状态栏等)
这种架构最大的好处是“按需取用”。你如果只需要表格数据展示和基本样式,可以不引入公式引擎;你如果要在自己的项目里定制一套完全不同的工具栏,只需要替换 UI 插件,不需要动数据模型和渲染层。
插件机制也意味着第三方可以贡献能力。比如有人写了图表插件、有人写了透视表插件,在官方仓库的 discussions 里经常能看到这类分享。对于企业二次开发,这意味着你不必每块能力都从零开始造,而是在生态里拼装。
3. 快速上手指南:从零搭建一个 univer 实例
3.1 环境准备与依赖安装
我先声明一下,univer 当前版本迭代非常快,以下步骤在当前文档环境下可用,但强烈建议你在实际操作时去官方文档核对最新的包名和 API。npm 上目前推荐用组合包 univer 统一入口,内部已经聚合了核心和常用插件,安装起来很省事。
我的操作环境是 Node 18 + Vite + TypeScript。新建一个项目后,执行安装:
概念上你要理解的是,univer 这个主包相当于“核心容器”,负责管理插件生命周期,具体功能由注册进去的各类插件提供。安装完成后,需要引入一套设计语言的基础样式,否则界面会裸奔:
3.2 初始化一个最小可用的表格
下面这段是当前版本下最精简的初始化代码。我把它拆开讲,不让你盲抄。
代码本身不难理解,但你可能会困惑:为什么有 SheetsPlugin 还要有 SheetsUIPlugin?答案藏在上面的架构拆解里:前者管数据模型和计算,后者管界面交互。这样设计是为了支持“纯数据模式”——你可以在不加载 UI 插件的情况下把 univer 当做一个表格计算引擎来用。
页面上需要准备一个容器节点:
刷新页面后,你会看到一个全新的空白表格,默认创建了一个空工作簿。网页上已经可以自由编辑单元格、插入行列、调整样式,这些能力都来自 UI 插件,不需要你写一行业务代码。
3.3 加载一份现有的 Excel 文件到表格中
实际项目里几乎不可能从空表格开始,用户一定会上传已有的 xlsx 文件。univer 的 xlsx 解析能力是通过插件实现的。你需要安装并注册 UniverSheetsIOPlugin:
然后在页面上放一个文件上传按钮,用 FileReader 读取文件内容并调用实例方法打开。
这里的重点在于格式兼容。我之前用 WPS 生成的文件、微软 Office 365 生成的文件都测过,基本都能正常打开,样式损失比预期小,但也不是零损失。尤其是图表、数据透视表这种复杂对象,目前还不能百分之百完美还原,如果你的用户重度依赖这些高级功能,需要提前做兼容测试。
3.4 配置多人协同编辑
协同配置是目前代码量比较多的部分,因为它不仅仅是一行 registerPlugin,还需要一个协作服务端来中转操作消息。univer 官方提供了 @univerjs/yjs 插件,原理是把表格的编辑操作同步到 Yjs 文档再通过 WebSocket 广播。
大致的接入思路是:
- 安装
yjs、y-websocket(或者自建 WebSocket 服务端); - 创建一个 Yjs 的
Y.Doc实例; - 注册
UniverYjsPlugin,并传入doc和workspace等参数。
然后通过 y-websocket 将 ydoc 同步到其他客户端。
这里有一个非常关键的认知:univer 的协同插件只负责“翻译”表格操作,它不负责网络传输的可靠性。消息是否及时送达、断线重连后怎么恢复,取决于你选择什么传输层。如果你只是内部团队几十人用,WebSocket 直连方案足够;如果要上公网,建议做一层消息队列缓冲,避免高峰期丢消息。
4. 横向对比:univer 与其他方案的核心差异
4.1 与 Luckysheet、SheetJS 的定位差异
很多人会拿 univer 和 Luckysheet 对比,因为它俩看起来都是“开源在线表格”。但实际定位差异还挺大的。
Luckysheet 是一个“成品”级别的项目,下载代码、打开网页、编辑器就出来了,交互体验不错,但在二次开发上,数据结构比较耦合,深入定制时容易碰到瓶颈。而且它早期版本在协同、公式扩展等方面,更多是靠社区插件弥补。
SheetJS 则完全是另一个维度,它不关心界面交互,专注在 xlsx 文件的解析和生成上,本质上是“文档处理库”。
univer 正好介于两者之间,既不直接给成品,也不是纯解析库,而是一个“可组装的基础设施”。打个比方,SheetJS 是卖发动机的,Luckysheet 是卖整车的,univer 是卖底盘平台的——你要装上自己的座椅和方向盘,但核心的悬挂、动力系统它已经给你弄好了。
4.2 与自研方案的本质区别
如果你所在的公司已经有很强的前端可视化团队,你可能会想:“凭什么要放弃控制权,用一个还在快速迭代的开源项目?”这是一个合理的担忧。但我见过的几个从零自研的案例,几乎都倒在了渲染引擎和公式引擎这两座大山下。
渲染引擎需要处理的事比你想象的多得多:选区绘制、单元格虚拟化、冻结行列、合并单元格、自动换行、多端滚动条差异……这些工作叠加起来,是一个持续消耗人力的深坑。公式引擎就更难了,光是兼容 Excel 的日期序列号规则、文本比较逻辑和循环引用检测就够写几个月的。
而 univer 的价值正是把这两座大山“开源共享”了。你自己只需要处理业务层和 UI 定制层的工作,风险降了一个量级。当然,开源项目的通病它也有,比如版本升级可能引入 breaking change,社区 issue 回复速度取决于运气。
5. 实际应用场景与性能调优经验
5.1 大数据量渲染的表现与优化
我专门用模拟数据做了压测:一张工作表有 20 万行、30 列,大概 600 万个单元格。默认情况下,滚动流畅度尚可,但首次渲染耗时比较长,内存占用也明显偏高。这是因为 univer 默认会对已加载区域内的所有单元格建立数据模型。
一个有效的优化是“懒加载 + 按需计算”。如果你原始数据就存在后端接口里,不要一次性全部灌进去,而是在 onScroll 或者视口变化时按区块拉取数据,填充到对应行区间。这样界面上看到的只是可视区附近的数据,内存压力能下降一个量级。
另外一个坑是公式计算。虽然 univer 的公式引擎会做脏单元格追踪,但如果你瞬间灌入几十万个带公式的单元格,计算队列依然会瞬间拉满。建议在批量导入数据时先临时禁用公式计算,等数据填充完成后再一次性触发重算。
5.2 多人协作的架构经验
我们内部团队最终选择了 Yjs,原因是它的服务端部署简单,不需要额外装数据库,启一个 WebSocket 进程就行。但上线后遇到一个典型问题:当某个用户一次性复制了一个大区域(几千行数据),粘贴操作会生成一个超大操作指令,广播给所有客户端,导致其他人短暂卡顿。
排查后发现,Yjs 对这种超大操作的支持并不好,它更适合细粒度的编辑操作。解决办法是把“一次粘贴”拆成“分块填充”逻辑,每块包含 100 行数据,分多条操作指令发送。这样做牺牲了一点同步速度,但提升了整体稳定性。
另外千万别忽略“光标状态”的同步。多人同时编辑时,用户最直观的体验就是看到其他人的鼠标在哪、正在选哪个单元格。这个数据量很小,但实现细节多:要处理滚动位置、视口偏移、用户名颜色等等,我们单独做了一套消息协议,才让协作体验达到“能用”的水平。
5.3 多端适配与移动端注意事项
univer 官方的一个卖点是“一套代码,多端运行”,实际上移动端也有不错的适配基础。但在真机上测了 iOS Safari 和 Android Chrome 之后,我的结论是:可以跑,但别指望体验一致。
移动端的核心痛点是“手势冲突”。Canvas 接管了渲染之后,浏览器的默认滚动手势和表格的拖拽选中手势是冲突的。你需要在初始化阶段配置手势策略,决定哪些区域允许页面滚动、哪些区域交给表格引擎处理。这个配置在多端之间还不一样,Android 上比较好办,iOS 的橡皮筋滚动效应对 Canvas 应用很不友好。
如果是企业内部辅助性场景,移动端将就能用;如果是面向 C 端用户的主流程,我建议还是优先做 Web 端,移动端后续再做交互重构。
6. 常见问题与排查技巧实录
6.1 常见问题速查表
| 症状 | 大概率原因 | 解决建议 |
|---|---|---|
| 表格空白,控制台无报错 | 容器节点没有高度 | 给父容器设置固定高度或 100vh |
| 中文输入法候选词不跟随光标 | Canvas 输入适配问题 | 升级到最新版本;配置默认字体为中文字体 |
| 导入 xlsx 后样式错乱 | 该文件包含高版本 Excel 专有对象 | 用代码排查未知对象类型,或提示用户另存为 xlsx 格式 |
| 协同编辑偶尔丢操作 | WebSocket 网络抖动或重连策略缺失 | 增加消息确认机制,断线重连后拉取增量快照 |
| 渲染大量数据时页面崩溃 | 一次性注入所有数据 + 大量公式 | 按视口懒加载,临时禁用公式计算 |
| 工具栏图标挤作一团 | 未引入设计系统样式 | 检查 @univerjs/design 的 CSS 是否已全局引入 |
6.2 独家避坑技巧
第一个坑:默认字体问题。univer 是 Canvas 绘制文字,它不继承 CSS 字体,所以如果你在 Linux 服务器上跑测试环境,而服务器上没有中文字体,表格里的汉字会全部变成方块。这个问题在本地 Mac 上永远不会暴露,一部署到服务器就现原形。解决办法是初始化时配置默认字体,同时在部署环境安装字体文件。
第二个坑:版本锁定要非常严格。univer 生态的包版本必须保持互相匹配,否则很容易出现“主包报错找不到某个模块”的问题。强烈建议用 lock 文件锁定精确版本,每次升级时挨个包一起升,不要单独升级某一个包。
第三个坑:别直接在生产环境用默认工具栏。默认的工具栏样式是为通用场景设计的,功能项很多。如果你的业务只是录入数据,建议通过 UI 插件配置裁剪掉大部分图标,少一些视觉干扰,也让用户更专注。这个定制过程能让你更深入理解它的插件体系,值得花半天时间做。
第四个坑:Excel 的打印功能是硬需求,但目前适配还比较弱。如果你的系统需要“导出 PDF”“套打报表”,不要指望 univer 原生支持。我们是把数据输出到 SheetJS 生成 xlsx,然后再交给后端做 PDF 转换,绕开了前端布局的地狱级差异。
7. 小结:我的实际体会
文章写到最后,想跟你分享一点最真实的感受。
我在实际使用中最头疼的其实不是渲染性能,而是 Canvas 渲染模式带来的“隐形认知负担”。你用 DOM 写页面,浏览器帮你处理了排版、字体、输入;一旦切到 Canvas,这些原本免费的午餐都要自己买单。univer 把这套复杂度压缩到了一个相对稳定的引擎层,但它不等于零成本——你仍然需要理解它的渲染机制,才能解释为什么有些样式生效、有些样式不生效。
横向对比下来,univer 的定位在开源表格项目里确实是独一份,它给的不是“鱼”也不是“渔”,而是“一艘能远航的船”。如果你正在被在线表格的需求折磨,我的建议是不要一上来就钻研源码,先把官方示例跑通,然后试着换肤、加按钮、注册一个自定义函数,用最小的代价体会它的插件体系。这比看十篇文章都有用。
后面我会继续跟进它的协同能力和移动端表现,如果社区里有新的实践沉淀,再回来补充。