一、项目介绍

想在网页或 Node 里嵌入一套在线表格、文档、幻灯片,过去意味着要么接一堆互不相通的开源库,要么买昂贵的商业套件。表格用这个、文档用那个,渲染层各写一遍,公式引擎和协作更是深坑。要做“类 Office 的可嵌入生产力”,成本居高不下。
Univer 把这件事收敛成一个高性能、可深度定制的 Office SDK:电子表格、文档、演示、关系表、白板、PDF 全在一个运行时里,基于 Canvas 渲染、带公式引擎,并用一套 Facade API 同时适配浏览器和 Node.js。插件化架构让你按需拼装能力,等于把“嵌入式 Office”做成了可组合的开发基座。

二、项目基本信息

信息项详情
项目名称Univer
GitHub地址https://github.com/dream-num/univer
项目描述The Office Harness for AI Agents — Spreadsheets, Docs, Slides, Canvas, Relational Tables, and PDF in one runtime.
作者dream-num
开源协议Apache-2.0
开源状态公开
LanguagesTypeScript
支持平台Web
最后更新2026-10-29

三、核心优势

  • 一套运行时:表格/文档/幻灯片/PDF 统一引擎
  • Canvas 渲染:高性能、可深度定制外观与交互
  • 完整公式引擎:电子表格能力开箱即用
  • 统一 Facade API:浏览器与 Node.js 同一套接口
  • 插件架构:按需扩展,方便嵌入自有产品

四、适用场景

适合做在线办公、低代码、数据看板、协同编辑的团队:需要在 Web 或 Node 中嵌入可定制的表格/文档/幻灯片能力,而不想分别集成多个库。

五、安装教程

当前最新版本 v1.2.0。按下方命令安装(如遇网络问题可切换镜像源或代理):

# 以电子表格为例,安装核心包与表格包
npm install @univerjs/core @univerjs/design @univerjs/sheets @univerjs/sheets-ui

常见报错:依赖缺失时先升级运行环境(Node、Python、Go 等)到项目要求版本;网络超时多为镜像或代理问题,可重试或换源。权限类报错请确认已登录对应平台账号。

六、使用示例

下面是一段可直接参考的真实示例:

import { Univer } from '@univerjs/core';
import { FUniver } from '@univerjs/core/facade';

const univer = new Univer({
  theme: 'light',
  locale: 'zh-CN',
});
// 通过 Facade API 创建并操作工作簿
const workbook = FUniver.newWorkbook();
workbook.setSheetName('Sheet1', '销售');

七、常见问题

问:必须前端框架吗?答:不必须,Univer 基于原生 Canvas,可嵌入任意前端或直接在 Node 使用。问:协作怎么做?答:官方提供协同方案,可结合插件搭建多人编辑。

八、总结

Univer 用一个清晰的设计,把把复杂能力封装成可嵌入的基座这件反复劳动变成了可复用、可维护的能力。它不追求大而全,而是把核心痛点解决得足够扎实——这正是日常开发与团队落地时最需要的那种工具。如果你也在被同类问题困扰,不妨按上面的安装与使用步骤试一试,把它接进自己的工作流。