Spire.OfficeJS 部署后需要配置有效的 License。没有 License 时,打开的文档会带红色试用提示,内容也会受限:Word 最多 500 个段落和 25 个表格,Excel 最多 5 个工作表,每个工作表最多 200 行,Presentation 和 PDF 最多 10 页。具体限制见官方下载页的试用版说明。
获取 License
购买 License 或申请有效期 30 天的临时 License,请联系 该Email地址已收到反垃圾邮件插件保护。要显示它您需要在浏览器中启用JavaScript。,或致电 028-81705109。
购买或申请试用后,你会收到一个 XML 格式的许可文件,文件名通常为 license.elic.xml。用文本编辑器打开该文件,复制根元素 <License Key="...">中 Key属性的值(不含引号和标签),填入下表中的对应字段。该文件带有数字签名,请勿修改。
License 配置
自带示例系统和自有前端项目使用相同的授权字段,只是配置位置不同。授权产品与对应字段如下:
| 授权产品 | License 字段 |
|---|---|
| Spire.OfficeJS | spireOfficeJsLicense |
| Spire.WordJS | spireDocJsLicense |
| Spire.ExcelJS | spireXlsJsLicense |
| Spire.PresentationJS | spirePresentationJsLicense |
| Spire.PDFJS | spirePdfJsLicense |
购买哪个产品,就把 License Key 填入对应字段,未购买的产品保持空字符串 ""。例如只购买了 Spire.WordJS,就填 spireDocJsLicense:
"editorAttrs":{"spireDocJsLicense":"WordJS License Key","spireXlsJsLicense":"","spirePresentationJsLicense":"","spirePdfJsLicense":"","spireOfficeJsLicense":""}如果购买的是 Spire.OfficeJS 套件授权,只填 spireOfficeJsLicense就行,其他四个字段留空。套件已经包含 Spire.WordJS、Spire.ExcelJS、Spire.PresentationJS、Spire.PDFJS 这四个产品。
License 填在哪里,要看你的使用方式:使用产品包自带的示例系统快速试用,或把编辑器集成到自己的前端项目。
方式一:使用自带示例系统(默认端口 3000)
使用产品包自带的示例系统时,授权字段位于 example/config/default.json的 server.customization下。下面只列出授权字段,其他配置不用动:
"customization":{"spireDocJsLicense":"WordJS License Key","spireXlsJsLicense":"","spirePresentationJsLicense":"","spirePdfJsLicense":"","spireOfficeJsLicense":""}保存后重启示例服务,新配置才会生效。
方式二:集成到自有前端项目
自有前端项目中,授权字段统一写在传给编辑器的 editorAttrs下。以 Vue 为例:
config.value ={"editorAttrs":{"spireDocJsLicense":"WordJS License Key","spireXlsJsLicense":"","spirePresentationJsLicense":"","spirePdfJsLicense":"","spireOfficeJsLicense":"",}};其他框架的写法一样,找到配置里的 editorAttrs,填入相同字段就行。
各框架的完整接入步骤可参考:JavaScript、Vue、React、Angular。
生效与验证
修改 editorAttrs后,保存并刷新页面就能生效。只改前端配置时,不需要重启 OfficeServer。
- Vue / React(Vite):一般会自动热更新。如果编辑器没有重新加载,先刷新页面,仍无效再运行
npm run dev。 - Angular:没生效时运行
ng serve。
改完后打开一个已授权产品的文档,检查是否还有红色试用提示。如果是套件授权,Word、Excel、Presentation 和 PDF 各打开一个文档看一下。









