一文搞懂 ONLYOFFICE 文档生成器：功能解析 + 多平台安装指南

办公自动化处理已成为企业提高效率的关键环节，作为一款强大的文档处理工具，ONLYOFFICE文档生成器为开发者提供了无缝集成文档生成、编辑和转换功能的解决方案。类似于 java 的 poi、easyExcel 等等，由代码级别操作 office 文档。

本文将对核心功能、优势特性、多平台安装步骤继续示例运行，带您全面掌握这款工具，助力办公效率提升。

一、什么是 ONLYOFFICE 文档生成器？

ONLYOFFICE文档生成器是一款跨平台的 Office 和 PDF 开发工具包（SDK），核心定位是“无需完整编辑器，即可实现文档的创建、编辑、转换自动化”。它支持 Office Open XML 格式（DOCX、XLSX、PPTX）和 PDF 文件的全流程处理，可通过 JavaScript API 无缝集成到文档管理系统、CRM、企业应用等各类程序中，适配服务器、移动和桌面多场景。

二、如何使用ONLYOFFICE文档生成器

ONLYOFFICE文档生成器提供了适用于多种编程语言的开发工具包，便于无缝集成到您的应用程序中。

• Python：在脚本或后端服务中生成和修改文档。
• C++：使用 C++ 库进行高性能文档处理。
• COM：通过组件对象模型（COM）接口与 Windows 应用程序集成。
• Java：借助 Java SDK 在企业应用程序中进行文档创建和编辑。
• .Net：使用 .NET SDK 开发适用于 Windows、Linux 和 macOS 的跨平台应用程序。

将 SDK 集成到您自己的应用程序中。如需安装 ONLYOFFICE Document Builder，请访问此页面。下载并解压文件后，该库即可用于集成。

三、ONLYOFFICE 文档生成器核心优势

ONLYOFFICE 文档生成器具有以下突出特性：

• 多格式兼容：支持超过 25 种文件格式的使用，能够处理 DOCX、XLSX、PPTX 等主流格式。
• 丰富的操作能力：通过 API 编程访问所有文档，可实现内容创建、修改、复制、合并、替换等多样化操作；
• 无第三方依赖：完全自包含，不依赖 Office 或其他插件；
• 平台独立性：支持 Windows、Linux、macOS 等多种操作系统
• 高性能和可扩展性：轻松适应您的业务规模
• 丰富的功能集：包含转换功能、文档对象模型、渲染功能等

四、安装方法详解

注意：

ONLYOFFICE文档生成器的免费版本会在所有生成的文档上添加水印。要去除此限制并使用全部功能，需要商业许可证。

先决条件

Python

• Python 3.10 - 3.12
• pip3。确保系统中已安装python3和pip3。您可以在终端中使用以下命令检查 Python 版本和 pip3 版本：

python3 --version python3 -m pip --version

C++

• 适用于 Windows 的 Visual Studio
• 适用于 Linux 的 GCC ≥ 4.2.1（32 位、64 位）或 GCC ≥ 8（64 位 ARM）
• 适用于 macOS 的 GCC ≥ 4.2.1

Java

• JDK ≥ 5。确保 JDK 已添加到path环境变量中。

.Net

• .NET SDK

安装步骤

ONLYOFFICE文档生成器提供了多种系统的安装路径，满足不同用户的对文档使用的需求。

备注：

对于 Python，您可以在终端中使用pip3安装document-builder库：

Windows 系统

1. 下载 Document Builder x64 或 Document Builder x86 SDK 压缩包。
2. 从.zip文件中提取文件夹。

Linux 系统

1. 下载 Document Builder aarch64 或 Document Builder x86_64 SDK 压缩包。
2. 通过tar xvzf onlyoffice-documentbuilder-linux-aarch64.tar.xz或tar xvzf onlyoffice-documentbuilder-linux-x86_64.tar.xz命令提取。

例如：

ARCH=$(uname -m) if [[ "$ARCH" == "aarch64" || "$ARCH" == "arm64" ]]; then FILE_NAME="onlyoffice-documentbuilder-linux-aarch64.tar.xz" else FILE_NAME="onlyoffice-documentbuilder-linux-x86_64.tar.xz" fi curl -L -o "$FILE_NAME" "https://github.com/ONLYOFFICE/DocumentBuilder/releases/latest/download/$FILE_NAME" mkdir -p builder tar xvJf "$FILE_NAME" -C builder

macOS 系统

1. 下载 Document Builder arm64 或 Document Builder x86_64 SDK 压缩包。
2. 通过tar xvzf onlyoffice-documentbuilder-macos-arm64.tar.xz或tar xvzf onlyoffice-documentbuilder-macos-x86_64.tar.xz命令提取。

例如：

ARCH=$(uname -m) if [[ "$ARCH" == "arm64" ]]; then FILE_NAME="onlyoffice-documentbuilder-macos-arm64.tar.xz" else FILE_NAME="onlyoffice-documentbuilder-macos-x86_64.tar.xz" fi curl -L -o "$FILE_NAME" "https://github.com/ONLYOFFICE/DocumentBuilder/releases/latest/download/$FILE_NAME" mkdir -p builder tar xvJf "$FILE_NAME" -C builder

运行示例

ONLYOFFICE文档生成器提供了多种编程语言的 SDK，满足不同开发环境的需求。

下载document-builder示例：

git clone https://github.com/ONLYOFFICE/document-builder-samples cd document-builder-samples

Python​​​​

1.执行configure.py并带上--test python参数：

python3 configure.py --test python

必要时，使用--dir参数提供 Document Builder 的目录。 这是生成包含 Document Builder 路径的辅助模块所必需的。

2.进入测试目录：

cd python/creating_basic_form

3.运行脚本：

python3 main.py

文档将在测试目录中创建。

C++（VS）

注意：仅在 Windows 上可用。

1.使用configure.py生成 VS 项目文件。例如：

python configure.py --vs --test cpp/creating_basic_form --test cpp/creating_advanced_form

2.在 Visual Studio 中打开.sln文件。它会提示您将 Windows SDK 和 VS 工具集重新定向到 您安装的版本 - 点击“确定”。

3.解决方案已准备好进行构建和运行。文档将在项目文件目录中创建。

C++（QT）

1.使用configure.py生成 Qt 项目文件。例如：

python configure.py --qt --test cpp

2.在 Qt Creator 中打开.pro文件。

3.项目已准备好进行构建和运行。文档将在build目录中创建。

Makefile

注意：仅在 Linux 和 macOS 上可用。

1.使用configure.py生成 Makefile。例如：

python configure.py --make --test cpp/filling_spreadsheet

2.进入生成的 Makefile 所在目录：

cd ../out/cpp/filling_spreadsheet

3.运行：

make

make将构建并运行可执行文件。文档将在与 Makefile 相同的目录中创建。

Java

注意：需要 JDK 8 或更高版本。

1.进入测试目录：

cd java/creating_presentation

2.编译Program.java，并提供位于 Document Builder 目录中的docbuilder.jar的路径：

javac -cp "C:\Program Files\ONLYOFFICE\DocumentBuilder\docbuilder.jar" Program.java

3.目录中应出现.class文件。运行程序：

java -cp "C:\Program Files\ONLYOFFICE\DocumentBuilder\docbuilder.jar;." Program

请注意，在 UNIX 系统上，路径分隔符是:而不是;。因此，在 Linux 或 macOS 上应为：

java -cp "/opt/onlyoffice/documentbuilder/docbuilder.jar:." Program

文档将在测试目录中创建。

.NET

注意：仅在安装了 Visual Studio 和 .NET SDK 的 Windows 上可用。

1.使用configure.py生成 VS 项目文件。例如：

python configure.py --vs --test cs

2.在 Visual Studio 中打开.sln文件。根据您安装的 .NET SDK 版本，您可能需要通过在 Visual Studio 项目属性中设置或直接编辑.csproj文件来更改目标框架。

3.解决方案已准备好进行构建和运行。文档将在项目文件目录中创建。

总结

ONLYOFFICE文档生成器作为一款轻量且强大的文档处理 SDK，解决了开发中的文档自动化需求 ——无论您是需要自动化生成报告、合同，还是构建文档管理系统，ONLYOFFICE 文档生成器都能为您提供可靠支持，要查看详细安装指南与运行示例，可访问此页面。