Java如何用代码高效操作Word文件内容与格式？

Java操作Word文件的实用方法与工具

在办公自动化和文档处理领域,Java作为一种广泛使用的编程语言，提供了多种方式来操作Word文件，无论是生成动态报告、批量处理文档，还是提取和修改Word内容，Java都能通过合适的库实现高效、灵活的操作，本文将详细介绍几种主流的Java操作Word文件的方法，包括Apache POI、docx4j、iText以及使用脚本引擎调用VBA宏，帮助开发者根据实际需求选择合适的解决方案。

使用Apache POI操作Word文档

Apache POI是Java操作Office文档最常用的开源库，支持对Word（.doc和.docx格式）的读写操作，其核心组件HWPF（用于.doc格式）和XWPF（用于.docx格式）提供了丰富的API，能够满足大多数文档处理需求。

添加依赖

在使用Apache POI之前，需在项目中添加相关依赖，以Maven为例，可在pom.xml中引入以下依赖：

<dependency>  
    <groupId>org.apache.poi</groupId>  
    <artifactId>poi</artifactId>  
    <version>5.2.3</version>  
</dependency>  
<dependency>  
    <groupId>org.apache.poi</groupId>  
    <artifactId>poi-ooxml</artifactId>  
    <version>5.2.3</version>  
</dependency>  

创建和写入Word文档

通过XWPF可以轻松创建新的.docx文件并写入内容，以下示例演示如何创建一个包含标题和段落的文档：

import org.apache.poi.xwpf.usermodel.*;  
public class CreateWord {  
    public static void main(String[] args) throws Exception {  
        XWPFDocument document = new XWPFDocument();  
        XWPFParagraph title = document.createParagraph();  
        title.setAlignment(ParagraphAlignment.CENTER);  
        XWPFRun run = title.createRun();  
        run.setText("Java操作Word文档示例");  
        run.setBold(true);  
        run.setFontSize(16);  
        XWPFParagraph paragraph = document.createParagraph();  
        run = paragraph.createRun();  
        run.setText("本文介绍使用Apache POI库创建和修改Word文档的方法。");  
        try (FileOutputStream out = new FileOutputStream("example.docx")) {  
            document.write(out);  
        }  
    }  
}  

读取和修改Word文档

Apache POI还支持读取现有文档并修改内容，替换文档中的特定文本或插入表格：

import org.apache.poi.xwpf.usermodel.*;  
public class ModifyWord {  
    public static void main(String[] args) throws Exception {  
        XWPFDocument document = new XWPFDocument(new FileInputStream("example.docx"));  
        for (XWPFParagraph paragraph : document.getParagraphs()) {  
            String text = paragraph.getText();  
            if (text.contains("Apache POI")) {  
                for (XWPFRun run : paragraph.getRuns()) {  
                    run.setText(text.replace("Apache POI", "Apache POI库"), 0);  
                }  
            }  
        }  
        // 插入表格  
        XWPFTable table = document.createTable();  
        XWPFTableRow row = table.getRow(0);  
        row.getCell(0).setText("姓名");  
        row.addNewTableCell().setText("年龄");  
        row = table.createRow();  
        row.getCell(0).setText("张三");  
        row.getCell(1).setText("25");  
        try (FileOutputStream out = new FileOutputStream("modified_example.docx")) {  
            document.write(out);  
        }  
    }  
}  

Apache POI的优势在于功能全面，适合处理复杂的文档结构，但缺点是对于.doc格式的支持相对有限，且内存占用较高。

使用docx4j处理.docx文档

docx4j是另一个专注于Open XML格式（如.docx）的开源库，相比Apache POI，它在处理复杂文档（如样式、图表）时更为高效。

添加依赖

<dependency>  
    <groupId>org.docx4j</groupId>  
    <artifactId>docx4j</artifactId>  
    <version>11.4.4</version>  
</dependency>  

示例：生成带样式的文档

import org.docx4j.openpackaging.packages.WordprocessingMLPackage;  
import org.docx4j.openpackaging.parts.WordprocessingML.MainDocumentPart;  
import org.docx4j.wml.P;  
public class CreateDocxWithDocx4j {  
    public static void main(String[] args) throws Exception {  
        WordprocessingMLPackage wordPackage = WordprocessingMLPackage.createPackage();  
        MainDocumentPart documentPart = wordPackage.getMainDocumentPart();  
        P title = documentPart.createParagraphOfText("标题");  
        title.getJaxbElement().getPPr().setJc(Justification.CENTER);  
        P paragraph = documentPart.createParagraphOfText("这是使用docx4j创建的段落。");  
        wordPackage.save(new File("docx4j_example.docx"));  
    }  
}  

docx4j的API更接近Open XML的底层结构，适合需要精细控制文档样式的场景，但学习曲线较陡峭。

使用iText生成简单Word文档

iText以处理PDF闻名,但其iText 5版本也支持简单的Word文档生成（.doc格式），需要注意的是，iText对.docx的支持有限，建议仅用于基础文本操作。

添加依赖

<dependency>  
    <groupId>com.itextpdf</groupId>  
    <artifactId>itextpdf</artifactId>  
    <version>5.5.13.3</version>  
</dependency>  
<dependency>  
    <groupId>com.itextpdf</groupId>  
    <artifactId>itext-rtf</artifactId>  
    <version>5.5.13.3</version>  
</dependency>  

示例：生成RTF格式的Word文档

import com.itextpdf.text.Document;  
import com.itextpdf.text.Paragraph;  
import com.itextpdf.text.rtf.RtfWriter2;  
public class CreateRtfWithIText {  
    public static void main(String[] args) throws Exception {  
        Document document = new Document();  
        RtfWriter2.getInstance(document, new FileOutputStream("itext_example.rtf"));  
        document.open();  
        document.add(new Paragraph("使用iText生成的RTF文档。"));  
        document.close();  
    }  
}  

iText的优势在于轻量级,适合生成简单的文本文档，但不适合复杂排版。

通过脚本引擎调用VBA宏

对于需要复现Windows平台上Word原生功能的场景,可以通过Java调用脚本引擎执行VBA宏。

示例：使用Nashorn引擎执行JavaScript调用Word

import javax.script.*;  
public class CallVBAWithScriptEngine {  
    public static void main(String[] args) throws ScriptException {  
        ScriptEngine engine = new ScriptEngineManager().getEngineByName("nashorn");  
        engine.eval("var word = new ActiveXObject('Word.Application');");  
        engine.eval("word.Visible = true;");  
        engine.eval("word.Documents.Add();");  
        engine.eval("word.Selection.TypeText('通过Java调用VBA宏插入的文本。');");  
    }  
}  

此方法依赖Windows环境,且需启用脚本引擎，适合集成现有VBA宏的场景。

总结与选择建议

根据需求选择工具：若需处理复杂.docx文档，推荐Apache POI或docx4j；若仅需生成简单文本，iText是不错的选择；若需调用现有VBA宏，可考虑脚本引擎，通过合理组合这些工具，Java可以高效完成各类Word文件操作任务。