用途:在 Node.js 环境中以无头方式运行 Univer 表格引擎,完成批量报表生成、服务端公式计算、批量数据读写与 JSON 快照导入导出,无需浏览器。
主要能力:创建并注册 Univer 实例与插件;通过 Facade API 创建工作簿、读写单元格、设置公式(如 =SUM(A1)*6);加载已有 JSON 工作簿并修改后保存;注册服务端自定义函数;可选使用 fork 工作进程处理繁重公式计算。Node.js 支持与浏览器同构。
使用方式:安装依赖 npm install @univerjs/core @univerjs/engine-formula @univerjs/sheets @univerjs/sheets-formula @univerjs/rpc-node;Pro 功能另装 @univerjs-pro/license 等包。创建实例后按顺序注册插件(引擎、RPC、单元核心、功能插件、Pro 功能),并用 FUniver.newAPI 获取 API。仅导入不依赖浏览器 API 的 facade,如 @univerjs/sheets/facade。重公式负载可用 UniverRPCNodeMainPlugin 与 UniverRPCNodeWorkerPlugin 配合 fork 进程,并在主进程侧传 notExecuteFormula: true。
适用场景:服务端报表与数据批处理、从数据库填充数据并计算汇总、导入导出工作簿 JSON、服务端公式与自定义函数计算。
限制:需省略所有 *-ui 插件、渲染引擎、CSS 与主题;部分 facade(ui 相关)在 Node.js 不安全;该技能假设已熟悉 univer-integrate 的基础插件架构与注册顺序,仅覆盖 Node.js 特有差异;版本兼容限于 Univer v0.21.x / Univer Pro v0.20.x。v0.21.x / v0.20.x 之外的兼容性、收费与定价资料暂未提供。