Univer 完整上手:免费把电子表格、文档和幻灯片嵌入你的产品
【免费下载链接】univerUniver is a full-stack framework for creating and editing spreadsheets / word processor / presentation on both web and server.项目地址: https://gitcode.com/GitHub_Trending/un/univer
想在自己的 SaaS、BI 工具或 AI 产品里加一个能编辑的电子表格,自己从零写不现实。Univer 就是干这个的:开源的全栈办公 SDK,电子表格、文档、幻灯片都能嵌。读完这篇,你能在本地把示例跑起来,知道去哪找渲染、公式的代码,也知道从哪个入口写自己的插件。
为什么值得投入
- 画布渲染 + 独立公式引擎:大工作簿、复杂公式不卡,适合做报表和重数据的协作场景。
- 插件化组装:想要筛选就装筛选,不要的零负担,适合只嵌一种能力的产品。
- 浏览器和 Node.js 同构:同一套 API 在服务端跑工作簿逻辑,适合 AI 生成表格、服务端导出这类链路。
5分钟跑起来
环境先备好:
- Node.js 22.18 及以上(仓库硬性要求,旧版本会直接报错)
- pnpm(monorepo 依赖它,别用 npm)
git clone https://gitcode.com/GitHub_Trending/un/univer cd univer && pnpm install pnpm dev开发服务起来后,页面里就有可操作的表格、文档示例,可以直接点着玩。
它能做什么
- 做报表:行列管理、数字格式、条件格式、筛选排序、数据验证、批注、交叉高亮全都有。数据量大、要专业表格体验时选它。
- 写长文:段落、标题、列表、上下标、超链接、页眉页脚。做富文本后台或在线协作文档时用得上。
- 拼幻灯片:演示文稿的核心编辑能力在迭代中,先了解,别指望它现在最成熟。
代码地图:去哪找哪块
- 数据模型与 Facade 入口 →
packages/core/ - 公式怎么算 →
packages/engine-formula/;画面怎么画 →packages/engine-render/ - 表格交互逻辑 →
packages/sheets/;界面组件 →packages/sheets-ui/ - 想看懂完整组合 → examples/src/sheets/ 的
main.ts
扩展与定制:三个入口
- 换功能组合:看
presets/packages/,官方预制了多种"包+插件"组合;examples/src/preset-sheets-core-with-worker/演示了公式引擎丢进 Web Worker 的做法。 - 加业务能力:照着 packages/sheets-filter/ 的结构写一个自定义插件。
- 改外观:主题色、字体走 Design Token,入口在
packages/themes/和 packages/design/。
踩坑提醒
- 依赖装不上或构建报错 → 大概率 Node 版本太旧(要求 22.18+)→ 换 Node 版本,清缓存重装。
- 用 npm 装完到处找不到包 → monorepo 只认 pnpm → 用
pnpm install重来。 - 想看示例却进了
examples/sheets/(不存在)→ 示例代码在examples/src/下,比如examples/src/sheets/main.ts。
下一步
从examples/src/sheets/main.ts读起,这是最完整的表格组合示例;API 稳定性说明看 docs/API_STABILITY.md,想自定义 UI 组件参考 CONTRIBUTING-FACADE.md。中文背景介绍在 docs/readme/zh-CN.md。跑不通就带着报错截图去项目 issues 区提问。
【免费下载链接】univerUniver is a full-stack framework for creating and editing spreadsheets / word processor / presentation on both web and server.项目地址: https://gitcode.com/GitHub_Trending/un/univer
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考