在文档管理与版本控制场景中，比较两个 Word 文档之间的差异是一个常见需求。无论是审阅合同修改稿、核对报告版本变更，还是检查文档模板的更新内容，都需要一种可靠的方式来识别两个文档之间的异同。本文将介绍如何使用 Java 语言，借助 Spire.Doc for Java 库，实现两个 Word 文档的内容比较功能。
一、环境准备
在开始编码之前，需要在 Java 项目中引入 Spire.Doc for Java 库。该库提供了一组操作 Word 文档结构的 API，其中包括文档比较功能。
若项目使用 Maven 管理依赖，可在 pom.xml 中配置以下内容：
xml
<repositories>
<repository>
<id>com.e-iceblue</id>
<name>e-iceblue</name>
<url>https://repo.e-iceblue.com/nexus/content/groups/public/</url>
</repository>
</repositories>
<dependencies>
<dependency>
<groupId>e-iceblue</groupId>
<artifactId>spire.doc</artifactId>
<version>14.4.9</version>
</dependency>
</dependencies>对于非 Maven 项目，可以手动下载 JAR 文件并将其添加到项目的 classpath 中。
二、文档比较的基本原理
文档比较的核心思路是将两个文档加载到内存中，然后逐段落、逐行、逐字符地分析差异。最终生成的比较结果通常以修订模式（Track Changes）的形式呈现，即原文档的内容保持不变，而新文档相对于原文档的增删改操作会被标记为修订记录。
这种方式的优势在于：比较结果可以直接在 Word 中打开查看，用户可以使用 Word 自带的"接受/拒绝修订"功能来处理每一处差异。
三、基础比较示例
Document 类提供了 compare 方法，可以直接将两个文档进行比较。以下示例演示了如何比较两个 Word 文档，并将比较结果保存为一个新文档。
java
import com.spire.doc.Document;
public class CompareDocumentsExample {
public static void main(String[] args) {
// 加载需要比较的两个文档
Document doc1 = new Document();
doc1.loadFromFile("Document_V1.docx");
Document doc2 = new Document();
doc2.loadFromFile("Document_V2.docx");
// 执行文档比较
// 参数说明：第二个文档，比较者的姓名，比较日期
doc1.compare(doc2, "Reviewer", new java.util.Date());
// 保存比较结果
doc1.saveToFile("ComparisonResult.docx", com.spire.doc.FileFormat.Docx_2013);
System.out.println("文档比较完成，结果已保存");
doc1.dispose();
doc2.dispose();
}
}上述代码中，doc1 被视为原始文档，doc2 被视为修改后的文档。比较结果会反映在 doc1 中，差异部分会以修订标记的形式呈现。最终保存的 ComparisonResult.docx 文件可以用 Microsoft Word 打开，差异内容会被标记为"插入"或"删除"。
四、比较结果的呈现方式
执行比较后，生成的文档中的修订标记具有以下特征：
- 删除的内容：通常显示为带删除线的文本（红色）。
- 新增的内容：通常显示为带下划线的文本（红色）。
- 未修改的内容：保持原样显示。
如果需要调整修订标记的显示样式，可以在 Word 中通过"审阅"菜单下的"修订"选项进行设置。这些样式控制属于 Word 软件本身的功能，而非 API 的控制范围。
五、高级比较选项
在某些场景下，可能需要对比较过程进行更精细的控制。例如，忽略格式差异、设置比较粒度等。当前版本的 compare 方法支持传入一个布尔参数来控制是否忽略格式差异。
java
import com.spire.doc.Document;
public class AdvancedCompareExample {
public static void main(String[] args) {
Document doc1 = new Document();
doc1.loadFromFile("Document_V1.docx");
Document doc2 = new Document();
doc2.loadFromFile("Document_V2.docx");
// 执行文档比较，传入 false 表示不忽略格式差异
// 即格式差异也会被标记为修订
doc1.compare(doc2, "Reviewer", new java.util.Date(), false);
doc1.saveToFile("ComparisonWithFormat.docx", com.spire.doc.FileFormat.Docx_2013);
System.out.println("带格式比较的文档已保存");
doc1.dispose();
doc2.dispose();
}
}如果希望忽略格式差异，可以将最后一个参数设为 true。这种情况下，只有当文本内容发生变化时才会产生修订标记，而字体、字号、颜色等格式变化不会被记录。
六、实际应用示例
以下是一个更完整的示例，展示了如何将文档比较功能嵌入到一个实际的工作流程中。该示例接收两个文档路径，输出比较结果文档的路径。
java
import com.spire.doc.Document;
import java.text.SimpleDateFormat;
import java.util.Date;
public class DocumentComparator {
/**
* 比较两个 Word 文档
* @param originalPath 原始文档路径
* @param revisedPath 修改后的文档路径
* @param outputPath 比较结果输出路径
* @param reviewerName 比较者姓名
* @return 比较是否成功
*/
public static boolean compareDocuments(String originalPath,
String revisedPath,
String outputPath,
String reviewerName) {
try {
Document original = new Document();
original.loadFromFile(originalPath);
Document revised = new Document();
revised.loadFromFile(revisedPath);
original.compare(revised, reviewerName, new Date());
original.saveToFile(outputPath, com.spire.doc.FileFormat.Docx_2013);
original.dispose();
revised.dispose();
return true;
} catch (Exception e) {
System.err.println("文档比较失败: " + e.getMessage());
return false;
}
}
public static void main(String[] args) {
String original = "./docs/Contract_v1.docx";
String revised = "./docs/Contract_v2.docx";
String output = "./docs/Contract_Comparison.docx";
boolean success = compareDocuments(original, revised, output, "System");
if (success) {
System.out.println("比较完成，结果已保存至: " + output);
} else {
System.out.println("比较失败，请检查文档路径是否正确");
}
}
}七、注意事项
在使用文档比较功能时，有几个限制和注意事项值得留意：
- 文档格式支持 ：比较功能主要适用于
.docx格式的文档。对于老旧的.doc格式，建议先进行格式转换。 - 表格与图像：表格内容、嵌入图像的比较可能不如纯文本精确，复杂文档结构需要额外测试验证。
- 性能考量：对于超长文档（数百页以上），比较操作可能消耗较多内存和时间，建议在服务器环境中适当分配堆内存。
- 修订模式依赖：比较结果依赖 Word 的修订模式显示，如果使用非 Word 阅读器打开，可能无法正常显示修订标记。
总结
通过上述示例可以看出，使用 Java 实现两个 Word 文档的内容比较的主要步骤是加载两个文档、调用 compare 方法、然后保存结果。比较结果以 Word 修订模式呈现，用户可以在 Word 中逐一审核每一处变更。这种方式适用于合同版本比对、文案修改审核、模板差异检查等多种场景。在实际项目中，可以根据需要将比较功能封装成工具方法，便于复用和集成。相较于手动逐页比对文档，程序化比较能够显著提升工作效率，同时减少人为遗漏的可能性。对于需要处理多个文档版本或定期执行文档比对的任务，该方案具有一定的实用价值。