纯Java实现Word中常见的编辑功能

2026-06-08 08:21:42 作者：缺点内向

在日常的企业级应用开发中,Word 文档的自动化处理是一个常见需求,本文介绍一个纯 Java 实现的 Word 文档操作库,通过具体的代码示例,实现对 Word 文档的文本替换、格式调整、内容增删等核心编辑功能,该方案不依赖本地 Office 环境,适合部署在 Linux 服务器上运行

在日常的企业级应用开发中，Word 文档的自动化处理是一个常见需求。相比于直接通过人工手动编辑，利用 Java 代码来动态修改文档内容，能极大地提升批处理和集成的效率。

本文介绍一个纯 Java 实现的 Word 文档操作库，通过具体的代码示例，实现对 Word 文档的文本替换、格式调整、内容增删等核心编辑功能。该方案不依赖本地 Office 环境，适合部署在 Linux 服务器上运行。

1. 环境准备与依赖引入

在开始编码之前，需要在 Java 项目中引入相关依赖。这里以 Maven 为例，在 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.6.0</version>
    </dependency>
</dependencies>

对于非 Maven 项目，可以手动下载 JAR 包并将其添加到项目的 Build Path 中。

2. 核心操作：编辑文档内容

该库提供了分层的对象模型来操作文档。一个 Word 文档通常包含多个 Section（节），每个节包含多个 Paragraph（段落），段落中则可以包含文本、图片等元素。

2.1 修改指定文本

修改文本是比较基础的操作。首先需要定位到具体的段落，然后调用 setText 方法来替换内容。

下面的示例演示了如何加载一个已有的 Word 文档，并修改其第一个段落中的文本：

import com.spire.doc.Document;
import com.spire.doc.FileFormat;
import com.spire.doc.Section;
import com.spire.doc.documents.Paragraph;

public class ModifyText {
    public static void main(String[] args) {
        // 创建Document对象并加载现有文档
        Document document = new Document();
        document.loadFromFile("原文档.docx");
        
        // 获取第一个节
        Section section = document.getSections().get(0);
        
        // 获取该节中的第一个段落
        Paragraph paragraph = section.getParagraphs().get(0);
        
        // 修改段落文本
        paragraph.setText("【新】这是一个被Java代码修改过的标题。");
        
        // 保存文档
        document.saveToFile("编辑后的文档.docx", FileFormat.Docx);
        
        // 释放资源
        document.dispose();
    }
}

2.2 格式化文本样式

除了文字替换，修改字体、颜色和样式在实际开发中也比较常见。在该库中，文本通常包含在 TextRange 对象里。可以通过遍历段落中的子对象，找到 TextRange 后调整其 CharacterFormat 属性。

以下代码展示了如何将特定段落的字体设置为蓝色、斜体并调整字号：

import com.spire.doc.Document;
import com.spire.doc.Section;
import com.spire.doc.documents.Paragraph;
import com.spire.doc.fields.TextRange;
import java.awt.*;

public class FormatText {
    public static void main(String[] args) {
        Document document = new Document();
        document.loadFromFile("样例文档.docx");
        
        // 获取第一个节的第二个段落
        Paragraph paragraph = document.getSections().get(0).getParagraphs().get(1);
        
        // 遍历段落中的子对象
        for (int i = 0; i < paragraph.getChildObjects().getCount(); i++) {
            Object obj = paragraph.getChildObjects().get(i);
            if (obj instanceof TextRange) {
                TextRange textRange = (TextRange) obj;
                // 设置字体名称
                textRange.getCharacterFormat().setFontName("微软雅黑");
                // 设置字体大小
                textRange.getCharacterFormat().setFontSize(14);
                // 设置字体颜色
                textRange.getCharacterFormat().setTextColor(Color.BLUE);
                // 设置为斜体
                textRange.getCharacterFormat().setItalic(true);
            }
        }
        
        document.saveToFile("格式化后的文档.docx", FileFormat.Docx);
        document.dispose();
    }
}

2.3 添加新内容（文本与图片）

除了修改现有内容，也经常需要在文档末尾或指定位置追加新的段落、文本或图片。

Section.addParagraph() 方法用于新增段落，而 Paragraph.appendText() 和 Paragraph.appendPicture() 则用于向段落中添加具体内容。

import com.spire.doc.Document;
import com.spire.doc.Section;
import com.spire.doc.documents.Paragraph;

public class AddContent {
    public static void main(String[] args) {
        Document document = new Document();
        document.loadFromFile("原文档.docx");
        
        // 获取文档的最后一个节
        Section lastSection = document.getLastSection();
        
        // 添加一个新的段落
        Paragraph newParagraph = lastSection.addParagraph();
        
        // 向段落中添加文字
        newParagraph.appendText("这是由Java程序自动追加的文字说明。");
        
        // 向段落中添加图片（请确保图片路径存在）
        // newParagraph.appendPicture("C:\\images\\logo.png");
        
        document.saveToFile("新增内容后的文档.docx", FileFormat.Docx);
        document.dispose();
    }
}

注：生产环境中建议对图片路径做存在性校验，避免文件未找到导致的异常。

2.4 删除指定段落

删除操作同样直接，只需获取到对应的 Paragraph 集合，调用 removeAt 方法并传入索引即可。

import com.spire.doc.Document;
import com.spire.doc.Section;

public class RemoveContent {
    public static void main(String[] args) {
        Document document = new Document();
        document.loadFromFile("原文档.docx");
        
        // 获取第一个节
        Section section = document.getSections().get(0);
        
        // 移除该节中的第一个段落（索引从0开始）
        section.getParagraphs().removeAt(0);
        
        document.saveToFile("删除段落后的文档.docx", FileFormat.Docx);
        document.dispose();
    }
}

3. 进阶应用：为关键词添加边框

为了让某些关键信息在文档中更加醒目，可以给特定的文本或整个段落添加边框。

该库提供了 findAllString 方法来查找指定的字符串，并可以针对匹配到的文本应用边框样式。

import com.spire.doc.Document;
import com.spire.doc.FileFormat;
import com.spire.doc.documents.BorderStyle;
import com.spire.doc.documents.TextSelection;
import java.awt.*;

public class HighlightText {
    public static void main(String[] args) {
        Document document = new Document();
        document.loadFromFile("报告.docx");
        
        // 查找文档中所有的“关键词”
        TextSelection[] selections = document.findAllString("核心技术", false, false);
        
        for (TextSelection selection : selections) {
            // 给找到的文本添加边框
            selection.getAsOneRange().getCharacterFormat().getBorder().setBorderType(BorderStyle.Single);
            selection.getAsOneRange().getCharacterFormat().getBorder().setColor(Color.RED);
            selection.getAsOneRange().getCharacterFormat().getBorder().setLineWidth(1);
        }
        
        document.saveToFile("高亮关键词.docx", FileFormat.Docx);
        document.dispose();
    }
}

4. 总结

通过上述示例可以看出，Spire.Doc for Java 提供了一套相对完整的 API 来操作 Word 文档。无论是在服务端批量生成报表，还是在客户端动态填充数据，这套工具都能帮助开发者在无需安装 Microsoft Office 的情况下完成常见的文档编辑任务。在实际开发中，需要注意操作完成后调用 document.dispose() 方法释放资源，以降低在高并发场景下发生内存泄漏的风险。

到此这篇关于纯Java实现Word中常见的编辑功能的文章就介绍到这了,更多相关Java操作Word内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！