java

关注公众号 jb51net

关闭
首页 > 软件编程 > java > Java生成Word文档

Java使用Spire.Doc for Java实现从零生成Word文档

作者：缺点内向

在日常的企业级开发中,报表生成、合同自动化和数据导出等场景,经常需要处理 Word 文档,本文以 Spire.Doc for Java 为例,从配置环境开始为大家详细介绍一下如何逐步实现一个包含文本、图片和表格的标准 Word 文档

在日常的企业级开发中，报表生成、合同自动化和数据导出等场景，经常需要处理 Word 文档。在 Java 生态中，除了 Apache POI 之外，也有一些商业或免费的组件可供选择，它们不依赖本地 Office 环境即可完成文档的创建与读写。

本文以 Spire.Doc for Java 为例，从配置环境开始，逐步实现一个包含文本、图片和表格的标准 Word 文档。

1. 环境准备

开始之前，请确认开发环境满足以下条件：

2. 项目依赖配置

在项目的 pom.xml 中添加仓库和依赖。国内用户可使用镜像仓库以加快下载速度：

<repositories>
    <repository>
        <id>com.e-iceblue</id>
        <name>e-iceblue</name>
        <url>https://repo.e-iceblue.cn/repository/maven-public/</url>
    </repository>
</repositories>
<dependencies>
    <dependency>
        <groupId>e-iceblue</groupId>
        <artifactId>spire.doc</artifactId>
        <version>14.4.9</version>
    </dependency>
</dependencies>

补充说明：

3. 核心对象模型

Spire.Doc for Java 的对象结构与 Word 文档的物理层级基本一致：

理解这四层关系后，代码的组织会相对清晰。

4. 代码实现：从零创建复杂文档

下面逐步编写一个示例，生成一份包含标题、作者信息、正文、图片和表格的工作报告。

4.1 创建文档与页面设置

首先创建 Document 和 Section 对象，并调整页面边距。

import com.spire.doc.*;
import com.spire.doc.documents.*;
import com.spire.doc.fields.DocPicture;
import java.awt.*;

public class CreateWordDemo {
    public static void main(String[] args) {
        // 创建文档实例
        Document document = new Document();
        
        // 添加一个节
        Section section = document.addSection();
        
        // 设置页面边距（上下左右各 2.5 厘米）
        section.getPageSetup().getMargins().setAll(2.5);
        
        // 后续代码继续追加...
    }
}

4.2 添加标题与作者信息

标题通常需要居中且加粗，作者信息可以设置为斜体或灰色。

// 添加主标题
Paragraph titlePara = section.addParagraph();
titlePara.getFormat().setHorizontalAlignment(HorizontalAlignment.Center);
TextRange titleText = titlePara.appendText("Java 自动化办公技术报告");
titleText.getCharacterFormat().setBold(true);
titleText.getCharacterFormat().setFontName("微软雅黑");
titleText.getCharacterFormat().setFontSize(22);

// 添加作者段落
Paragraph authorPara = section.addParagraph();
authorPara.getFormat().setHorizontalAlignment(HorizontalAlignment.Center);
TextRange authorText = authorPara.appendText("作者：稀土掘金开发者 | 日期：2026-05-06");
authorText.getCharacterFormat().setItalic(true);
authorText.getCharacterFormat().setFontSize(12);
authorText.getCharacterFormat().setTextColor(Color.GRAY);

// 添加一个空行作为间距
section.addParagraph();

4.3 添加正文段落

正文需要设置首行缩进，以符合中文排版习惯。

// 添加正文段落
Paragraph contentPara = section.addParagraph();
String text = "本文演示了使用 Java 组件生成 Word 文档的基本流程。"
                + "该方法不依赖于本地安装的 Office 软件，可部署在 Linux 服务器上运行。"
                + "下面展示一个示例图片与进度表格。";
contentPara.appendText(text);
contentPara.getFormat().setFirstLineIndent(24); // 首行缩进24字符

4.4 插入图片

插入图片时，可以指定宽度和高度进行缩放。

// 插入图片段落
Paragraph imagePara = section.addParagraph();
imagePara.getFormat().setHorizontalAlignment(HorizontalAlignment.Center);

// 请将实际图片路径替换为你本地的文件
DocPicture picture = imagePara.appendPicture("C:\\temp\\sample_image.png");
picture.setWidth(300);
picture.setHeight(200);

4.5 添加表格

表格操作中，需要注意表头的样式设置，以及避免重复添加段落。下面创建一个 3 行 3 列的表格，并填充示例数据。

// 表格标题
Paragraph tableTitlePara = section.addParagraph();
tableTitlePara.appendText("项目进度清单：");
tableTitlePara.getFormat().setBold(true);

// 创建表格 (指定 3 行, 3 列)
Table table = section.addTable(true);
table.resetCells(3, 3);

// 设置表格宽度
table.setWidth(500, TableWidthType.Point);
table.getTableFormat().setCollapseBorders(true);

// ----- 设置表头（第 1 行）-----
TableRow headerRow = table.getRows().get(0);
// 清空单元格默认占用的空白段落，避免重复
for (int i = 0; i < 3; i++) {
    headerRow.getCells().get(i).getParagraphs().clear();
}

String[] headers = {"模块名称", "进度", "负责人"};
for (int i = 0; i < headers.length; i++) {
    Paragraph p = headerRow.getCells().get(i).addParagraph();
    p.appendText(headers[i]);
    p.getFormat().setHorizontalAlignment(HorizontalAlignment.Center);
    p.getItems().get(0).getCharacterFormat().setBold(true);
    headerRow.getCells().get(i).getCellFormat().setVerticalAlignment(VerticalAlignment.Middle);
}

// ----- 第 2 行数据 -----
TableRow row2 = table.getRows().get(1);
row2.getCells().get(0).getParagraphs().clear();
row2.getCells().get(1).getParagraphs().clear();
row2.getCells().get(2).getParagraphs().clear();
row2.getCells().get(0).addParagraph().appendText("需求分析");
row2.getCells().get(1).addParagraph().appendText("已完成 100%");
row2.getCells().get(2).addParagraph().appendText("张三");

// ----- 第 3 行数据 -----
TableRow row3 = table.getRows().get(2);
row3.getCells().get(0).getParagraphs().clear();
row3.getCells().get(1).getParagraphs().clear();
row3.getCells().get(2).getParagraphs().clear();
row3.getCells().get(0).addParagraph().appendText("后端开发");
row3.getCells().get(1).addParagraph().appendText("进行中 70%");
row3.getCells().get(2).addParagraph().appendText("李四");

注意：addTable(true) 会自动为每个单元格创建一个空白段落，因此写入数据前先调用 clear() 是一个较为稳妥的做法，可以避免内容重复。

4.6 保存文档

最后将文档写入磁盘，并释放资源。

// 保存文档
String outputPath = "output/created_demo.docx";
try {
    document.saveToFile(outputPath, FileFormat.Docx);
    System.out.println("文档生成成功，路径：" + outputPath);
} catch (Exception e) {
    e.printStackTrace();
} finally {
    document.dispose();
}

5. 运行结果

执行 main 方法后，会在项目根目录的 output 文件夹中生成 created_demo.docx 文件。打开后可以看到：

6. 补充说明

实际开发中可能遇到以下几个情况：

通过上述步骤，可以在不依赖本地 Office 软件的前提下，使用 Java 完成 Word 文档的创建与内容填充。这一思路适用于报表生成、合同批量处理等自动化场景。

到此这篇关于Java使用Spire.Doc for Java实现从零生成Word文档的文章就介绍到这了,更多相关Java生成Word文档内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:
阅读全文