Headless Web SDK

Univer 具备同构特性,不仅可在浏览器端运行,还能在 Node.js 环境下使用。你可以基于 Headless Univer 开发数据处理服务,在服务器端生成或修改文档,并通过 Facade API 与 Univer Docs 进行交互。

预览

Headless Univer 与浏览器端的使用方式类似,在预设模式下我们提供开箱即用的预设包;而在插件模式下,你仅需把涉及 UI 的插件排除即可。

预设模式

安装

Shell
pnpm add @univerjs/preset-docs-node-core

使用

TypeScript
import { UniverDocsNodeCorePreset } from '@univerjs/preset-docs-node-core'import docsNodeCoreZhCN from '@univerjs/preset-docs-node-core/locales/zh-CN'import { createUniver, LocaleType, mergeLocales } from '@univerjs/presets'async function run(): Promise<void> {  const { univer, univerAPI } = createUniver({    locale: LocaleType.ZH_CN,    locales: {      [LocaleType.ZH_CN]: mergeLocales(        docsNodeCoreZhCN,       ),    },    presets: [      UniverDocsNodeCorePreset(),     ],  })  // 你可以在这里任意调用 Facade API 进行文档处理}run()

插件模式

安装

Shell
pnpm add @univerjs/core @univerjs/engine-render @univerjs/engine-formula @univerjs/docs

使用

TypeScript
import { LocaleType, Univer, UniverInstanceType } from '@univerjs/core'import { UniverDocsPlugin } from '@univerjs/docs'import { UniverFormulaEnginePlugin } from '@univerjs/engine-formula'import { UniverRenderEnginePlugin } from '@univerjs/engine-render'const univer = new Univer({  locale: LocaleType.ZH_CN,  locales: {    [LocaleType.ZH_CN]: {},  },})univer.registerPlugin(UniverRenderEnginePlugin)univer.registerPlugin(UniverFormulaEnginePlugin)univer.registerPlugin(UniverDocsPlugin)univer.createUnit(UniverInstanceType.UNIVER_DOC, {})

你觉得这篇文档如何?

© 2026 DreamNum Co., Ltd.