GitHub 今日推荐|univer:可嵌入 Web 应用的开源 Office 引擎

一句话看懂
项目地址:https://github.com/dream-num/univer

Univer 是面向开发者的办公套件引擎库,用 TypeScript 实现表格、文档、幻灯片的编辑、计算与协作功能。应用通过统一 API 调用模型操作、监听事件、保存快照,无需自行处理公式解析、命令撤销、多人冲突等底层逻辑。核心引擎 Apache-2.0 许可,商业插件与服务端 SDK 单独分发。
仓库主语言 TypeScript 占 59552203 字节,Star 27747,当日新增 1659,Fork 2525。创建于 2022-09-29,最新版本 v1.5.2 发布于 2026-11-16。
它解决什么问题
SaaS 产品或 AI 工具常需内嵌表格编辑、公式计算、文档协作能力。从零开发涉及公式引擎、撤销重做、协同冲突解决等复杂模块,维护成本高。直接集成第三方 Office 服务则面临数据出境、定制受限、成本不透明问题。
Univer 提供可本地部署的 SDK,将编辑器组件、计算引擎、命令系统打包为预设(预先组合好的插件集合),开发者通过 Facade API(应用层调用接口,隔离内部实现)操作工作簿、单元格、监听生命周期事件,获得接近 Excel 或 Google Sheets 的交互能力。插件化架构允许替换或扩展功能模块,适配自有业务逻辑。项目覆盖表格(Sheets)、文档(Docs)、幻灯片(Slides)三类场景。
核心概念速览
Preset(预设):预先组合的插件集合,简化初始化。UniverSheetsCorePreset 打包表格编辑、公式计算、样式渲染等核心模块,开发者传入容器 ID 即可启动完整编辑器。
Facade API:应用层接口,封装内部模型操作。univerAPI 暴露 createWorkbook、getActiveWorkbook、sheet.getRange().setValue() 等方法,开发者无需直接操作 Command 或底层数据结构。
Snapshot(快照):序列化为 JSON 的文档状态。workbook.save() 返回快照对象,包含所有工作表数据、样式、公式定义。应用将快照写入数据库实现持久化,下次通过 createWorkbook(snapshot) 恢复状态。
Command System(命令系统):统一编辑和撤销重做的执行机制。所有修改封装为命令对象,通过命令队列执行,自动生成历史记录。跨功能协调时,命令系统保证操作原子性与顺序一致性。
依赖注入容器(Injector):基于 @wendellhu/redi 库实现的依赖管理。插件将服务注册到容器,运行时按需解析依赖树。
架构拆解

Univer 采用分层模块化架构,核心分五层:
core 层(packages/core):提供依赖注入容器、插件生命周期管理、命令系统基础。Injector 维护服务实例,Plugin 基类定义启动与销毁接口。
引擎层(packages/engine-*):实现领域逻辑。engine-formula 解析公式语法、构建依赖图、执行计算;engine-render 处理 Canvas 渲染、文本排版、滚动视口。
功能插件层(packages/*):封装具体功能。sheets 提供单元格编辑、选区操作;docs 处理富文本、段落样式;slides 管理幻灯片页面。
预设层(presets/*):组合插件与配置。preset-sheets-core 依赖 core、engine-formula、sheets 等模块,按默认顺序注册插件、加载语言包、绑定 UI 组件。
Facade 层(packages/facade):统一应用接口。FUniver 类封装 createWorkbook、监听生命周期事件;FWorkbook 封装保存、获取工作表;FRange 封装读写单元格。
数据流:应用调用 Facade API → Facade 构造命令对象 → 命令系统分发到插件 → 插件修改模型并调用引擎 → 引擎触发渲染或计算 → 事件回调通知应用。
关键实现走读
依赖注入注册
/**
* Register the dependencies to the injector.
* @param injector The injector to register the dependencies.
* @param dependencies The dependencies to register.
*/
export function registerDependencies(injector: Injector, dependencies: Dependency[]): void {
dependencies.forEach((d) => injector.add(d));
}
做了什么:遍历依赖数组,将每个服务定义添加到注入器容器。Dependency 包含服务类、标识符、生命周期配置。
为什么这样写:预设初始化时需批量注册数十个插件与服务,统一函数简化调用代码。forEach 保证注册顺序,避免循环引用或缺失。
没有它会怎样:每个预设需手动调用 injector.add 数十次,插件间依赖关系需开发者手动维护,错误难以排查。
初始化与工作簿创建
import { UniverSheetsCorePreset } from '@univerjs/preset-sheets-core'
import UniverPresetSheetsCoreEnUS from '@univerjs/preset-sheets-core/locales/en-US'
import { createUniver, LocaleType, mergeLocales } from '@univerjs/presets'
import '@univerjs/preset-sheets-core/lib/index.css'
const { univerAPI } = createUniver({
locale: LocaleType.EN_US,
locales: {
[LocaleType.EN_US]: mergeLocales(UniverPresetSheetsCoreEnUS),
},
presets: [
UniverSheetsCorePreset({
container: 'app',
}),
],
})
univerAPI.createWorkbook({})
做了什么:createUniver 创建依赖注入容器,加载语言包,执行预设的插件注册流程,将编辑器渲染到 id="app" 的 DOM 节点。univerAPI 返回 Facade 实例,createWorkbook({}) 生成空白工作簿。
为什么这样写:预设模式隐藏插件列表与注册顺序细节,开发者只需传入容器 ID 与语言配置。mergeLocales 合并基础与扩展语言包,支持自定义翻译。
没有它会怎样:开发者需逐个导入十几个包,手动创建 Injector、按依赖顺序注册插件、配置 UI 渲染器,初始化代码超过百行。
动手上手

环境要求:Node.js ≥22.18。推荐使用 pnpm。
安装依赖
pnpm add @univerjs/presets @univerjs/preset-sheets-core
创建 HTML 容器
<div id="app" style="width: 100%; height: 600px;"></div>
容器需显式指定高度,否则编辑器不可见。
编写初始化代码
import { UniverSheetsCorePreset } from '@univerjs/preset-sheets-core'
import UniverPresetSheetsCoreEnUS from '@univerjs/preset-sheets-core/locales/en-US'
import { createUniver, LocaleType, mergeLocales } from '@univerjs/presets'
import '@univerjs/preset-sheets-core/lib/index.css'
const { univerAPI } = createUniver({
locale: LocaleType.EN_US,
locales: {
[LocaleType.EN_US]: mergeLocales(UniverPresetSheetsCoreEnUS),
},
presets: [
UniverSheetsCorePreset({
container: 'app',
}),
],
})
univerAPI.createWorkbook({})
可验证结果:浏览器打开页面后看到空白工作簿,工具栏显示字体、对齐、公式按钮,单元格可输入文本与公式。
监听生命周期并操作单元格
LifecycleStages.Steady 表示公式引擎初始化完成。getRange(0, 0) 获取 A1 单元格,setValue 写入内容。save() 返回快照对象存入 localStorage。
可验证结果:A1 单元格显示 Hello Univer,浏览器 Local Storage 中出现 univer-snapshot 键值。
从快照恢复
const savedSnapshot = JSON.parse(localStorage.getItem('univer-snapshot'))
univerAPI.createWorkbook(savedSnapshot)
可验证结果:刷新页面后编辑器显示之前保存的内容与样式。
应用场景
在线协作工具嵌入表格编辑器:SaaS 项目管理工具调用 createUniver 初始化编辑器,通过 save() 将快照存入后端。监听 onCommandExecuted 事件实时推送变更到协作服务器。注意多人协同需集成商业协作插件或自行实现操作转换逻辑。
AI 代理自动化处理表格:AI 助手在 Node.js 环境运行 Univer 引擎,通过 Facade API 创建工作簿、写入数据、应用公式,生成快照后返回或导出为 Excel。注意无界面模式需参考官方 Headless 指南配置。
企业内部报表系统:后端生成快照数据,前端通过 createWorkbook(snapshot) 渲染编辑器。用户调整筛选条件后,调用 Range API 更新数据源,公式引擎自动重算。注意图表、数据透视表等高级功能属于商业插件范围。
开发自定义功能扩展:继承 Plugin 基类开发自定义插件,通过命令系统监听单元格变更,在工具栏注册按钮并绑定回调。注意需保持 @univerjs/* 包版本同步。
独立分析


适合需嵌入 Office 功能的 SaaS 或 AI 产品。Facade API 降低调用门槛,相比 Google Sheets API 可本地部署,避免数据出境。
插件化降低功能耦合与定制门槛。依赖注入容器实现模块解耦,命令系统协调跨功能编辑,开发者可替换计算引擎、扩展菜单项,无需修改核心库。
开源范围仅核心引擎,Server SDK(协同后端)、AI SDK、部分插件(数据透视表、图表库)需商业许可。企业使用前需评估功能清单与授权成本。
与 Luckysheet 等开源表格项目相比,Univer 架构覆盖文档、幻灯片、表格三类场景,TypeScript 类型定义完整,商业扩展(协作、AI、移动端适配)更全面。
局限与风险
运行时浏览器兼容性要求未明确。项目使用 Canvas 渲染与 Web Workers 计算,需确认目标浏览器是否支持 ES2020 语法、OffscreenCanvas 等特性。移动端性能与触控交互适配情况未体现。
部署方式、服务端依赖未详述。多人协作需部署 WebSocket 服务与数据库存储快照,但技术栈、协议规范、集成步骤需查阅官方文档。
商业功能边界需查阅官网 Feature Comparison。条件格式、数据验证、图表类型、协同编辑、权限管理等功能是否包含、是否需付费未明确列出。
AI SDK 集成方式与工具协议未覆盖。是否支持 LangChain、Function Calling、结构化输出等主流 AI 工具协议未说明。Node.js 环境运行时的性能与并发处理能力也未给出基准数据。
结论卡片

适合:前端或全栈开发者需在 Web 应用中嵌入表格、文档编辑能力,或构建协同办公产品。团队接受 TypeScript 技术栈,需定制菜单、公式函数或集成自有业务逻辑。AI 工具开发者需让代理自动化处理 Office 文档。
不适合:仅需文档预览或静态导出 PDF,无编辑与协作需求。团队无前端开发能力,期望开箱即用的完整产品而非 SDK。不接受商业插件授权模式,要求所有功能完全开源。
后续步骤:查阅官方文档确认商业功能范围与授权方式,在官网 playground 测试核心编辑器性能与交互体验。评估目标浏览器兼容性,确认是否需部署协作后端。如需高级功能,联系团队获取 Feature Comparison 与报价。
项目地址:https://github.com/dream-num/univer
更多推荐



所有评论(0)