Univer：跨端全栈开源办公工具，支持表格 / 文档 / 幻灯片一体化创建与编辑

一、Univer是什么？

Univer是一款开源的全栈办公工具框架，支持在Web和服务器端创建、编辑电子表格（Sheet）、文档（Doc）与幻灯片（Slide），具备同构运行、高性能、可扩展、易嵌入的核心优势。其提供丰富功能，包括多类公式计算、条件格式、数据透视表、协同编辑、国际化等，同时通过插件化架构支持开发者定制需求。该框架基于Apache-2.0许可证开源，可免费商用（非OSS版本含额外功能与付费升级选项），适用于AI数据展示、企业嵌入式办公、团队协作等场景，为开发者和企业提供灵活的办公文档解决方案。

核心定位：区别于传统办公工具

传统办公工具（如Microsoft Office、Google Workspace）是“成品软件”，用户需在固定界面中使用功能；而Univer是“框架级解决方案”，核心价值在于“嵌入与定制”：

• 嵌入性：可无缝集成到AI产品、企业管理系统、教育平台等场景，作为数据展示或内容编辑模块；

• 定制性：通过插件架构添加行业专属功能（如财务数据校验、教育作业批改），或修改主题适配自有产品UI；

• 同构性：在浏览器（前端）和Node.js（服务器端）使用相同API运行，支持服务端生成报表、前端实时编辑的全流程需求。

二、功能特色：覆盖表格、文档、幻灯片的全场景办公能力

Univer的核心功能围绕“表格（Sheet）、文档（Doc）、幻灯片（Slide）”三大模块展开，同时提供跨模块的通用能力（如国际化、协同），形成完整的办公生态。以下通过模块拆分与表格对比，详细介绍其功能亮点。

1. 三大核心模块功能详解

三大模块分别对应不同办公场景，功能成熟度各有差异（Sheet最稳定，Slide处于开发中），具体对比如下：

2. 跨模块通用特色

除三大模块的专属功能外，Univer还提供全场景通用能力，提升整体使用体验：

• 国际化支持：官方提供10种语言版本，包括中文（zh-CN/zh-TW）、英文（en-US）、俄语（ru-RU）、越南语（vi-VN）、波斯语（fa-IR）、韩语（ko-KR）、西班牙语（es-ES/ca-ES）；支持自定义语言包，开发者可添加小众语言或行业专属术语。

• 高性能设计：

• 渲染层：基于Canvas而非DOM渲染，减少浏览器重排重绘，支持万级数据表格流畅滚动；

• 计算层：公式引擎可在Web Worker（前端）或服务器端运行，避免计算任务阻塞界面响应；

• 资源优化：采用滚动缓冲、按需加载策略，长文档/大数据表格加载更快。

• 易上手的API：提供“Presets & Facade API”——Presets是预配置的功能集合（如“基础表格包”“协同编辑包”），开发者可一键引入；Facade API封装底层复杂逻辑，简化调用（如univerAPI.getActiveDocument()获取当前文档）。

• 主题定制：支持自定义颜色、字体、按钮样式，通过CSS变量或主题配置文件适配自有产品UI，避免“办公模块与产品风格割裂”的问题。

三、技术细节：支撑跨端办公体验的底层架构

1. 同构架构：浏览器与服务器一致运行

“同构”是Univer的核心技术亮点之一，指其代码可在浏览器（前端）和Node.js（服务器端）环境中无缝运行，且API完全一致。实现逻辑如下：

• 环境适配层：抽象浏览器与Node.js的差异（如DOM操作、文件系统），提供统一接口（如前端用document.createElement，服务端用虚拟DOM库，上层代码无需感知差异）；

• 核心逻辑共享：公式计算、数据解析（XLSX/DOCX）、文档模型等核心代码在两端共用，避免“前端一套逻辑、服务端另一套逻辑”的冗余开发；

• 典型应用场景：服务端生成日报/月报表格，前端用户基于该表格实时编辑；或服务端验证用户提交的表格数据（如公式正确性），前端同步展示验证结果。

2. 渲染引擎：基于Canvas的高效可视化

Univer放弃传统办公工具常用的“DOM渲染”，选择Canvas作为核心渲染载体，原因在于DOM渲染在“大数据/长文档”场景下易出现卡顿（如万行表格需创建大量DOM节点）。其Canvas渲染引擎的核心设计：

• 分层渲染：将文档分为“内容层”（文本/数据）、“格式层”（颜色/边框）、“交互层”（选中状态/光标），各层独立更新，避免整体重绘；

• 文本排版优化：支持“标点挤压”“行高自适应”等中文排版细节，同时兼容英文单词换行规则；

• 滚动缓冲：仅渲染当前视口内的内容（如表格只渲染可见行/列），滚动时预加载相邻内容，实现“无缝滚动”体验。

3. 公式引擎：快且稳定的计算核心

Univer Sheet的公式能力是其核心竞争力之一，公式引擎的设计重点在于“性能”与“兼容性”：

• 多环境运行：支持在Web Worker（前端）或服务器端运行，前端使用Web Worker可避免复杂公式（如统计函数）阻塞界面；

• 丰富函数库：内置300+常用函数，覆盖数学（SUM/MAX）、统计（AVERAGE/MEDIAN）、逻辑（IF/AND）、文本（CONCAT/LEFT）、日期（TODAY/DATEDIF）等类别，兼容Excel函数语法，降低用户学习成本；

• 计算优化：采用“增量计算”策略——仅重新计算被修改单元格关联的公式，而非全表重算，提升大数据表格的计算效率。

4. 插件化设计：灵活扩展功能（表格解析）

Univer的功能扩展完全基于插件架构，核心与插件解耦，开发者可按需加载或自定义插件。其插件体系结构如下：

插件开发门槛较低，框架提供完整的插件开发文档（见“官方链接”部分），开发者可基于现有插件模板快速开发功能。

5. 数据处理与协同：保障内容安全与团队协作

• 导入导出兼容性：支持XLSX（表格）、DOCX（文档）格式的导入导出，兼容主流办公软件生成的文件，避免“格式错乱”问题；导出PDF时支持自定义页面大小、页边距，满足打印需求；

• 协同编辑：非OSS版本支持多用户实时编辑，通过“操作日志同步”实现光标位置、编辑内容的实时同步，同时提供“编辑历史”功能，支持恢复到任意历史版本；

• 权限控制：支持对表格单元格、文档段落设置权限（如“只读”“可编辑”），适合企业场景中敏感数据的权限管理。

四、应用场景：适配多行业的办公需求

1. AI产品数据展示与分析

AI产品（如数据分析工具、BI平台）常需将分析结果以表格/图表形式展示，Univer可作为“数据可视化模块”嵌入：

• 场景示例：AI生成用户行为分析报告后，通过Univer Sheet生成带图表的表格，用户可在前端实时修改筛选条件（如时间范围），表格数据与AI分析结果联动更新；

• 核心优势：Canvas渲染支持大数据图表流畅展示，公式引擎可实时计算AI输出的原始数据（如计算转化率、增长率）。

2. 企业级应用嵌入式办公组件

企业管理系统（如ERP、CRM）常需内置简单办公功能，避免用户切换到第三方办公软件：

• 场景示例：CRM系统中，销售数据录入后，通过Univer Sheet生成销售报表，支持销售经理在线编辑批注（如调整目标值），并导出为XLSX文件存档；

• 核心优势：同构架构支持服务端自动生成报表（如每日凌晨生成前一天销售数据表格），前端用户直接编辑，减少数据流转环节。

3. 开发者定制化办公工具

开发者可基于Univer的插件架构，开发行业专属办公工具：

• 场景示例：财务公司开发“财务报表工具”，基于Univer Sheet添加“发票数据校验插件”（自动校验发票金额公式正确性）和“税务规则插件”（按税率自动计算税额）；

• 核心优势：插件化设计无需修改框架核心代码，降低定制成本，且可复用Univer的基础功能（如导入导出、格式设置）。

4. 教育场景的协作式学习

在线教育平台可利用Univer的协同编辑功能，实现师生协作：

• 场景示例：老师在Univer Doc中创建作业模板（含题目和答题区域），学生在线填写答案，老师实时批注纠错；或学生小组基于Univer Sheet协作完成数据统计作业（如问卷调查结果分析）；

• 核心优势：任务列表、批注功能适合作业管理，协同编辑支持实时互动，避免文件反复传输。

5. 小团队轻量化办公协作

小团队（如创业公司、工作室）可使用Univer的开源版本搭建轻量化办公系统，替代付费办公软件：

• 场景示例：团队通过Univer Sheet管理项目进度（任务名称、负责人、截止日期），通过Univer Doc编写会议纪要，支持多人实时编辑，无需购买Google Workspace或Microsoft 365；

• 核心优势：开源免费，部署灵活（可部署在自有服务器），避免数据存储在第三方平台的安全顾虑。

五、使用方法：从环境搭建到项目嵌入

1. 环境准备：安装依赖工具

首先需安装开发所需的基础工具，确保环境兼容：

• Node.js：版本需≥16.0.0（推荐18.x LTS版本），用于运行前端项目和依赖管理；

• pnpm：版本≥7.0.0，Univer使用pnpm作为包管理器（仓库含pnpm-lock.yaml文件，确保依赖版本一致）；

• 代码编辑器：推荐VS Code（仓库含.vscode配置文件，可直接使用）。

安装步骤：

1. 下载Node.js：从Node.js官网下载并安装18.x LTS版本，安装时勾选“Add to PATH”；

2. 安装pnpm：打开终端，执行命令npm install -g pnpm，全局安装pnpm；

3. 验证环境：终端执行node -v（显示≥16.0.0）和pnpm -v（显示≥7.0.0），确认安装成功。

2. 克隆仓库与运行示例

通过克隆GitHub仓库，可快速运行Univer的示例项目，体验核心功能：

1. 克隆仓库：打开终端，执行命令git clone https://github.com/dream-num/univer.git，将仓库代码下载到本地；

2. 进入项目目录：执行cd univer，切换到项目根目录；

3. 安装依赖：执行pnpm install，安装项目所有依赖（依赖较多，建议耐心等待）；

4. 运行示例：执行pnpm run dev，启动开发服务器，默认端口为3000；

5. 访问示例：打开浏览器，输入http://localhost:3000，即可看到示例页面（含表格、文档、幻灯片的演示案例）。

3. 嵌入自有项目：基础代码示例

若需将Univer嵌入自有项目，可通过npm安装核心包，以下以“嵌入基础表格功能”为例：

1. 安装核心包：在自有项目根目录执行pnpm install @univerjs/core @univerjs/sheet @univerjs/ui；

2. 初始化Univer：在项目代码中引入包并初始化表格，示例代码如下：

// 引入Univer核心包和表格包
import { Univer } from '@univerjs/core';
import { SheetPlugin } from '@univerjs/sheet';
import { defaultTheme } from '@univerjs/ui';

// 1. 创建Univer实例
const univer = new Univer({
 theme: defaultTheme, // 使用默认主题，可自定义
});

// 2. 注册表格插件
univer.registerPlugin(SheetPlugin);

// 3. 获取表格插件实例
const sheetPlugin = univer.getPlugin(SheetPlugin);

// 4. 创建工作簿（含一个默认工作表）
const workbook = sheetPlugin.createWorkbook({
 name: '我的第一个表格', // 工作簿名称
});

// 5. 获取默认工作表
const worksheet = workbook.getActiveSheet();

// 6. 向单元格写入数据
worksheet.setValue({ row: 0, col: 0 }, '姓名'); // A1单元格写入“姓名”
worksheet.setValue({ row: 0, col: 1 }, '年龄'); // B1单元格写入“年龄”
worksheet.setValue({ row: 1, col: 0 }, '张三'); // A2单元格写入“张三”
worksheet.setValue({ row: 1, col: 1 }, 25); // B2单元格写入25

// 7. 将表格渲染到页面DOM元素（需在页面中创建id为“univer-container”的div）
univer.renderTo(document.getElementById('univer-container'));

3. 页面展示：在HTML中添加容器元素<div id="univer-container" style="width: 100%; height: 600px;"></div>，运行项目后即可看到表格渲染结果。

4. 参考资源：提升使用效率

• Presets仓库：Univer提供Presets Repository，包含预配置的功能集合（如“协同编辑预设”“图表预设”），可直接引入，减少配置代码；

• 官方文档：通过docs.univer.ai查看详细API文档、插件开发指南、常见问题；

• 示例代码：仓库examples/目录下有多个场景示例（如多实例表格、协同编辑），可参考学习。

六、常见问题解答（FAQ）

1. Univer与Excel、Google Sheets有什么区别？

Univer并非“替代Excel的软件”，而是“办公能力框架”，核心区别在于：

• 定位不同：Excel是独立软件，Univer是可嵌入的框架，需集成到自有应用中使用；

• 扩展性不同：Univer支持插件化定制（如添加行业专属功能），Excel仅支持宏或有限插件；

• 部署方式不同：Univer可部署在自有服务器（开源版本），数据存储可控；Excel需依赖微软云或本地存储。

2. Univer支持移动端运行吗？

根据官方文档，Univer当前主要支持Web和Node.js环境，移动端（iOS/Android）支持处于规划中，暂未提供正式的移动端适配方案。若需在移动端使用，可通过浏览器访问Web版本，但可能存在界面适配（如按钮大小、滚动体验）问题，需开发者自行优化。

3. 开源版本与非OSS版本有哪些功能差异？

文档中标注“¹”的功能属于非OSS版本特性，两者核心差异如下：

4. 协同编辑功能需要自行搭建服务器吗？

是的，Univer的协同编辑功能（非OSS版本）需要开发者自行搭建“协同服务器”，框架仅提供前端协同逻辑，不包含服务器端实现。官方文档提供协同服务器的基础设计思路（如操作日志同步、冲突解决），但未提供现成的服务器代码，需开发者基于Node.js或其他后端技术实现。

5. Univer支持哪些浏览器版本？

官方未明确列出支持的浏览器版本，但根据其技术栈（Canvas、Web Worker），推荐使用现代浏览器最新版本，包括：

• Chrome ≥ 90

• Firefox ≥ 88

• Safari ≥ 15

• Edge ≥ 90 不支持IE浏览器，且旧版浏览器可能存在渲染或功能异常（如公式计算报错、滚动卡顿）。

七、相关链接

• GitHub仓库：https://github.com/dream-num/univer

• 官方网站：https://univer.ai

八、总结

Univer是由DreamNum开发的跨端全栈开源办公框架，以“支持表格/文档/幻灯片一体化创建与编辑”为核心，通过同构架构实现Web与服务器端一致运行，依托Canvas渲染、Web Worker公式引擎保障高性能体验，并以插件化设计支持灵活扩展。其开源版本基于Apache-2.0许可证免费商用，提供基础办公功能（如表格编辑、文档排版、XLSX/DOCX导入导出），非OSS版本含数据透视表、协同编辑等高级功能且支持付费升级。该框架适用于AI数据展示、企业嵌入式办公、开发者定制工具、教育协作等场景，文档完善且社区活跃，开发者可通过克隆仓库快速体验示例，或通过简单API将其嵌入自有项目。整体而言，Univer为需要办公能力的应用提供了“低成本、高灵活”的解决方案，平衡了开源自由与商用实用性，是办公框架领域的重要开源项目。