Univer深度评测:Web端Excel表格引擎的选型与实战
说实话,如果你团队碰过"在 Web 端和 Excel 死磕"这个活,一定对"表格控件到底该选谁"这件事纠结过很多次。2023 年之后,这个问题多了一个相当有分量的新选项:univer。它不是一个简单的表格 UI 库,而是由 DreamNum 团队开源的一套办公套件引擎,核心卖点是基于 Canvas 渲染、插件化架构、对 Excel 兼容性做了完整闭环,并且天然把多人协作的状态同步机制考虑了进去。我第一次看到这个标题时也觉得夸张,但真正把它接进工程、跑通 XLSX 导入导出之后,才意识到这个项目的野心比想象中更大。这篇文章不吹不黑,只说一个实际接手过表格组件的人,是怎么用 univer 搭出一套可用的 Web 表格,以及哪些地方值得你花时间,哪些地方会踩坑。
1. 被 Excel 兼容性折磨过的团队,到底栽在过哪些坑里
1.1 Web 端表格的老路子,本质上是在"绕路"
在写代码之前,我想先把背景聊透。过去想在浏览器里做一套"能打开 xlsx、能编辑单元格、能算公式、能协同"的表格,你的选择真的不多。最常见的一条路是用 SheetJS 这种解析库,把 xlsx 当成"数据文件"解压出来,读出单元格的值和一个粗略的样式对象,再灌到某个表格组件里渲染。这个方案十分钟就能跑通,但问题是它只能处理"表格=数据网格"的理想情况。
现实里的 Excel 文件是什么样?一个单元格可能带着边框、字体、列宽行高、数字格式,旁边有合并单元格,表格中间还有条件格式、图表、数据透视表、跨 sheet 公式。这些东西在 xlsx 文件里是一套极其复杂的 XML 结构,它们互相嵌套、互相引用。你把这份文档解析成 JSON 数组的那一刻,就等于把一张立体的图纸压扁成了平面数据,回头再想原样导回 Excel,基本不可能。所以很多团队做出来的 Web 表格,打开普通 xlsx 还行,一遇到"财务模板""销售报表"这类复杂文件就全线溃败,不是样式错位,就是公式显示成了字符串。
还有一条路是用 Luckysheet 这类开源控件。它在交互体验上已经做得相当不错,网格线、单元格编辑、公式栏、下拉填充都有。但它底层还是 DOM 渲染,加上旧代码包袱、引擎和 UI 深度耦合,真到了大表格性能优化和二次业务定制的时候,拓展性会很吃力。更关键的是,Luckysheet 对 Excel 文件的支持并没有想象中完整,很多 2016 版 Excel 之后才有的格式特性跟它对接不上。
1.2 univer 的定位变了:不是表格组件,是一套引擎
univer 真正让我耳目一新的点,是它把定位从"表格控件"拉高到了"文档引擎"。它底层维护的核心数据结构是 workbook、worksheet、cell,这套模型天然是 Excel 的映射;在此基础上它通过插件机制把这些能力一层层包上去:你想有公式,注册公式插件;你想有 UI,注册 UI 插件和 Sheet UI 插件;你想有数据校验、条件格式、超链接、批注,也都是插件的拼装。
这种设计带来的改变是本质性的。过去的表格组件把"数据和 UI"焊死在一起,你很难在业务层面对单个行为做拦截和重写;而 univer 把操作抽象成 command,UI 上的每一次点击、每一次输入,本质上都是产生一个 command 交给核心引擎去执行。这也意味着:同一份表格数据,你可以在不打开界面的情况下做公式计算;同一个用户操作,你可以记录、回放、同步给其他在线用户。后面我会专门讲这个架构带来的协作能力,那才是 univer 最大的底牌。
另外,很多人搜"univer"其实是搜"univer在线"。这个热搜词反映了一个真实需求:大多数人并不想研究源码,他们只是需要一个"像 Excel 一样好用、又不用安装客户端"的在线表格。Univer 官方确实提供了在线办公套件方向的托管产品,社区里也有很多团队把 open source 版本集成进自己的 SaaS 平台。理解这个背景之后,你再看 univer 的技术方案,会更容易明白它为什么要做重引擎 + 可嵌入组件这套组合。
1.3 为什么是 2023 年之后重新看表格赛道
表格这个赛道非常古老,但"Web 端重构 Excel"这个命题一直没被彻底解决。WPS 的 Web 端、腾讯文档、飞书表格都是大厂自研,外面的人用不了;OnlyOffice 太沉,部署和集成成本不低;开源的又很难做到"Excel 兼容 + 协作 + 高性能"三者兼备。univer 聪明的地方在于:它没有再做一个孤立的表格应用,而是一个可以嵌入任意前端框架的引擎层。你可以把它接进 React、Vue,也可以完全脱离框架用原生 JS 调用。
对开发者来说,这套思路和当年 VS Code 做编辑器、Figma 做在线设计工具的路数是一致的:先用底层模型把文档的逻辑讲清楚,再用渲染层保证复杂交互的流畅度,最后用插件体系让业务方按需裁剪。看懂这个定位,就能理解 univer 为什么值得花时间,而不是又一个昙花一现的开源组件。
2. 十分钟跑起一个能用的 Univer Sheets:从安装到初始化
2.1 环境准备与工程落点
先别管复杂的架构,直接动手。我用 Vite + React 起了一个最小工程,建议你也这样做,因为 Vite 的依赖预构建和热更新对这套包比较友好。
当前版本的核心依赖就是这五个。如果你后面需要做 Excel 导入导出,再额外看官方文档里对应的导入导出包,以你安装时的版本为准。npm 包命名和版本变化比较快,这篇文的代码价值更多在于思路,而不是让你无脑复制。
2.2 最小可运行代码与注册顺序
工程建好后,核心代码其实很短。在 App 组件里放一个 container,然后在 useEffect 里实例化 Univer:
我第一版代码把 plugin 注册顺序写反了,结果项目能跑,但工具栏始终不出现,表格区域也没有滚动条,控制台上没有任何报错。排查了一圈才发现是 UniverUIPlugin 必须在 UniverSheetsUIPlugin 之前注册。UI 插件先搭好布局插槽,业务 UI 插件再去填充内容;反过来注册,核心引擎觉得插槽不存在,就直接把 UI 层跳过了。
另外,container 参数接受的是 DOM 节点,不是选择器字符串。很多从 jQuery 时代过来的人容易传 '#app' 进去,结果表格渲染在了一个不存在的容器上。在 React 里建议用 ref 拿节点,并且确保节点在 useEffect 执行时已经挂载完成。
2.3 从空工作簿到写入数据
Univer 初始化之后,工作区里默认出现的是一个空白 Sheet。接下来的实际操作是:先创建一部分测试数据,验证公式和样式渲染。如果你只是想在界面上敲数据,直接点单元格就能编辑,体验和 Excel 非常接近;如果你想用代码注入数据,就需要走数据模型的创建接口,通过 univer 实例拿到当前 workbook。
这里我想强调一件事:上手 univer 的第一周,最重要的事情不是研究 UI 上有什么按钮,而是理解它的数据模型。你可以把 workbook 类比成一本钉装好的记账簿,每个 worksheet 是一页账纸,cell 是账纸上的格子。所有公式、样式、数据绑定都围绕这套模型展开。想往 A1 单元格写内容,操作的本质是修改模型里的这个 cell,UI 只是模型的投影。想明白这一点,后面做批量导入、表单联动、权限控制都会顺很多。
3. 拆开看:Univer 的插件化架构与 Canvas 渲染为什么值得信赖
3.1 插件机制:能力是一块块拼上去的
Univer 核心包本身不包含任何按钮、菜单、滚动条,它只有数据模型和基础计算逻辑。这么说有点抽象,打个比方:核心引擎是一台没有方向盘和座椅的汽车底盘,你想让它变成能开的车,需要按需把方向盘、座椅、仪表盘装上去。Univer 的插件就是这些部件。
官方维护的插件覆盖了相当多场景:sheets-formula 负责公式计算,在函数编辑器里能弹出的函数列表就来自它;sheets-conditional-formatting 管条件格式;sheets-data-validation 管下拉数据和校验规则;还有批注、超链接、主题色、排序筛选等。你自己业务里如果有一个"批量把某列设置成黄色背景"的按钮,甚至不需要找官方插件,直接写一个自定义插件,调用核心的样式接口就行。
这种架构最大的好处是按需打包。如果你只是把 xlsx 文件读取并展示在页面上,完全不需要注册公式插件和工具栏插件,依赖体积能缩得比较小。坏处也很明显:学习曲线陡峭,刚接触时你会觉得"为什么开源项目连个删除线样式都要单独找接口",但用一段时间,你会习惯这套"能力即插件"的写法。
3.2 Canvas 渲染的取舍:流畅背后的代价
Univer 渲染层没有用 DOM 表格,而是用 Canvas 做分块绘制。这也是它敢对标 Excel 大文件浏览体验的底气所在。DOM 方案在单元格数量从一千涨到十万的时候,每个单元格都是一堆 DOM 节点,滚动一下,浏览器要重新计算布局,性能曲线会迅速恶化;Canvas 方案把整个可视区域当成一张画布,只绘制当前视窗内的单元格,配合虚拟滚动,数据量再大,界面上的节点数量是恒定的。
当然,Canvas 渲染不是免费的午餐。它在性能上的优势,是用巨大的开发成本换来的:你要在 Canvas 上自己绘制网格线、选区边框、编辑光标、缩放手势、拖拽填充效果,还要处理不同屏幕的像素比,保证文字渲染在高 DPI 屏幕上不发虚。这些复杂度过去靠 CSS 和 DOM 自动解决,现在全部变成了引擎的自觉行为。Univer 把这些啃下来了,才敢说自己是"像 Excel 一样流畅"。
3.3 命令栈与状态驱动:一切编辑都是 command
我前面反复提到 command,这是理解 univer 内部逻辑的关键钥匙。在 univer 的思路里,用户任何一次操作——输入一个数字、合并单元格、修改行高、设置字体加粗——都不是直接改 DOM,而是生成一个 command 对象,里面记录了"你要做什么、参数是什么、作用在哪个 sheet、哪个 range 上"。核心引擎收到 command 后,会先走权限校验、再执行对应的业务流程、更新数据模型,最后通知 UI 层重绘。
这套机制对普通开发者初次接触时会显得绕,但它带来的好处非常硬核:因为每个操作都是可描述、可记录的对象,所以你天然获得了撤销重做能力;因为操作序列可以被同步、被回放,所以多人协作可以建立在同一套 command 基础上。我后面在讲协作时你会更清晰地感受到:univer 不是把表格和协同硬拼在一起,而是从骨子里就是为协同设计的。
4. 真实 Excel 文件导入导出:兼容性到底能不能打
4.1 导入 xlsx:把文件真正打开看看
很多人使用 univer,第一个动作就是拿一份自己手头的 xlsx 文件导入。这一步体验相当重要,因为它决定了这个项目能不能在生产环节替代客户的"发个 Excel 给我"这种协作方式。
univer 官方 UI 上默认带"打开"按钮,可以直接选本地文件。如果你要自己写代码控制导入流程,思路也是清晰的:先把 File 对象转成 ArrayBuffer,再用官方导入插件解析,解析结果直接写入 workbook 数据模型,UI 自然就会刷新。需要注意的是,导入插件不是核心包里自带的,需要单独安装对应依赖。很多新手在官方文档里找不到导入按钮,就是因为只装了核心包和 UI 包,没有装导入导出相关插件。
我测试时用的是一份 8000 行、带 20 多个公式、多处合并单元格、还有几张图表的销售月报。导入过程大概两秒多,数据、公式、样式基本都在,公式在导入后是保留公式文本的,不是计算结果死值。能做到这一步,已经比很多宣称"支持 Excel"的开源组件强很多了。
4.2 导出:走一条可逆的路径
导入之后必须能导出,这才能形成一个完整闭环。univer 的导出能力同样通过插件提供,我实测导出的文件用本地 WPS 和 Excel 打开,常用样式和数据基本保持。这里我特别关注的是公式:你导入时保留公式文本,导出时也应该还原成公式文件,而不是默默地变成静态值。univer 在这方面做得不错,至少在常规的 SUM、IF、VLOOKUP 场景下,导出的文件是可编辑可重算的。
导出时有一个要注意的点:如果你在 univer 里用了它特有的功能(比如某些自定义命令生成的批注格式),这部分内容会因为缺少对应序列化规则,导出后丢失。这不是 univer 的单方面问题,而是所有 Web 表格都面临的"能力边界"问题。我的经验是,关键时刻可以做一个"导出前检查清单",明确哪些 Excel 原生功能是重点保障的,哪些可以接受丢失。
4.3 兼容性实测清单:哪些过关,哪些别抱期望
我把实际测过的能力整理成一张表,状态代表我在当前版本中的测试结果,不代表未来版本:
| 功能 | 兼容情况 | 使用建议 |
|---|---|---|
| 基础文字、单元格背景、边框 | 完全可用 | 可以放心依赖 |
| 合并单元格、冻结行列 | 可用 | 表现稳定 |
| 数字格式(日期、货币、百分比) | 大部分可用 | 个别自定义格式需测试 |
| 常用公式(SUM/IF/VLOOKUP 等) | 可用 | 复杂动态数组公式要观察 |
| 图表 | 体验有限 | 不要作为核心卖点 |
| 数据透视表 | 早期阶段 | 谨慎使用 |
| 条件格式 | 部分支持 | 导入后可显示,编辑需确认 |
| 宏、VBA | 不支持 | 商业 Excel 的专属领域 |
这张表的结论是:univer 在"单元格级"的兼容性已经可以打,但在"图表级""透视表级"还有不少路要走。如果你的业务强依赖 Excel 图表,目前还是需要另外的方案兜底;如果只是单元格数据录入、公式计算、报表导出,univer 已经堪用。
5. 多人协作模式:本地操作与服务器回放的取舍
5.1 "univer在线"热搜背后的真实需求
前面提到过"univer在线"这个词,很多人搜它是在找一个可以直接打开、不用本地开发、能多人同时编辑的在线表格。这个需求背后是大量中小企业正在经历的现实:内部还在用微信传来传去的 xlsx,版本混乱、数据各自为政,但又没有预算上整套办公 SaaS。
univer 开源的引擎给了这些团队一个自建在线表格的底座,官方也有对应的托管版和协作服务方向。我的建议是:在决定自建之前,先想清楚你是"需要表格功能"还是"需要协同能力"。
5.2 单机版改造:协作的本质是一串可回放的操作
如果决定自建,协作这块避不开。univer 的协作思路和传统"传文件"完全不同:它不把整份 Excel 文件通过网络传来传去,而是把每个人的操作抽象成一条条 command,同步的是"操作流"而不是"最终文件"。
你可以这样想象:教室里几个学生同时在黑板不同区域写字,每个人写下的每一笔都是一个操作;只要老师统一记录这些笔画的顺序,任何晚到的人都能够通过"按顺序重放每一笔"看到黑板的最终样子。univer 的 command 流就是黑板上的笔画。每个客户端本地操作即时生效,然后这批 command 被送到服务端,服务端负责给它们排定顺序,再广播给其他客户端回放。
这个模型的难点在于冲突处理:两个人同时编辑同一个单元格怎么办?一个人删除了一列,另一个人正在往这列的第三个单元格输入内容怎么算?这些不是通信层面的问题,而是文档状态一致性问题。univer 社区版本提供了一些基础能力,真要跑到商用级别,还需要自己垫平不少坑。
5.3 我的自建协作建议
如果你不是做基础设施的,我真心不建议一上来就挑战多人协同。先用 univer 做"上传 xlsx -> 单人编辑 -> 导出下载"的轻方案,把 Excel 兼容性这关过了,再考虑多人实时协同。很多人之所以卡在协同上,不是因为 univer 不够好,而是因为丢失了"操作排序"这个最核心的约束。真到了那一步,你还要面对服务端存储、回放性能、在线状态管理、WebSocket 集群等一系列问题。
办公文档协同是这个领域最难的技术之一,不要被"开源版支持协同"这句话迷惑。我的看法是:先用官方托管或聚焦单机闭环,把商业逻辑跑通,这是最稳妥的落地路径。
6. 如果我再次选型 Web 表格组件,我会怎么考虑
6.1 不同类型表格组件的适用边界
univer 不是万能的。做选型的时候,我习惯把需求分成几个档位,不同档位选不同武器。为了帮你少走弯路,我按"从轻到重"做了一个对比:
| 需求场景 | 推荐方案 | 理由 |
|---|---|---|
| 只是展示数据列表 | AG Grid / Element Plus Table | 轻量、生态成熟、学习成本低 |
| 需要类 Excel 编辑体验 | univer 或 OnlyOffice | 兼容性、编辑体验完整 |
| 需要强二次开发的自定义弹窗交互 | Handsontable | 更轻便,定制空间大 |
| 需要多人协同 + 完整办公套件 | univer 在线方向 / 商业办公 SDK | 协同链路复杂,自研成本高 |
| 需要完整 Office 文档兼容 | OnlyOffice | 支持 Word、PPT 全套 |
这个表格不是想说谁好谁坏,而是避免拿一个重型引擎去解一个轻型问题。如果只做一个"本月数据总量"的看板,你完全没必要引入 univer;同样,如果业务方明确说"我要像 Excel 一样编辑公式、格式、批注",那 AG Grid 就算功能再全面,也会在兼容性上让你陷入被动。
6.2 什么时机引入 univer 这种重型引擎
我的经验是:当需求里出现"导入 xlsx 后原样编辑""支持复杂公式""有可能做多人实时协同"这三条中的任意两条时,就可以考虑 univer 了。因为它虽然重,但它的数据模型已经替你规划好了从单机走向协同的路径。如果刚开始用轻量表格,后面再迁移到 univer,工作量和历史包袱会让你非常痛苦。
引入 univer 的时候还要注意组织成本。它不是一个能给刚入门的前端同事半小时上手的组件,你需要有人先研究它的插件体系、数据模型、命令机制,然后把它包装成公司的公共组件。这个学习成本是真实的,但它换来的是后续业务扩展的空间。
6.3 几个值得继续盯的方向
我用 univer 之后,最感兴趣的几个方向,也可以给你参考。一是把 excel 导入解析后作为低代码平台的数据源,让用户用表格建模,可视化生成 API;二是结合公式引擎做在线财务计算器,用户填几个变量,报表实时重算;三是把 univer 的 command 流接到业务审计系统里,记录每一次编辑操作,这在合规场景下很有价值。
如果你还有余力,可以关注下它背后的 Doc 和 Slide 模块。现在 Sheet 是主力,但办公套件三件套的方向已经定下了。可以想象,如果团队能把 Excel、Word、PPT 三套能力统一建在同一套插件架构上,对一个 SaaS 产品的想象空间是非常大的。
最后说点私人感受。我踩过 Web 表格选型最深的坑,是那种"先用轻量组件搭起来,后期发现支撑不住再换"的节奏。univer 给我的安心感在于:它的核心模型和 command 机制,让我知道自己做的每一步扩展都在往长期正确的方向走。无论你最终是否选择 univer,我都建议你先把它跑起来,哪怕只导入一份 xlsx 随便划拉几下,也比光看文档更能理解这套引擎的魅力。表格这东西,亲手试过才有发言权。