在 Java 中使用 GroupDocs 文档比较 API 比较 Excel 文件的方法

快速答案

  • GroupDocs 能在 Java 中比较 Excel 文件吗？ 是的 – 只需使用 Comparer 类加载 .xlsx 文件并调用 compare。
  • 如何忽略页眉/页脚？ 在 CompareOptions 中设置 setHeaderFootersComparison(false)。
  • 大 PDF 文件怎么办？ 增加 JVM 堆内存，启用流式模式，并使用内存优化选项。
  • 我可以比较受密码保护的 PDF 吗？ 在创建 Comparer 时提供密码。
  • 有没有办法更改高亮颜色？ 使用 StyleSettings 为插入、删除和修改的项目设置样式。

什么是 Excel 文件比较（Java）？

在 Java 中比较 Excel 文件指的是以编程方式检测两个 .xlsx 工作簿之间的每个单元格级别的添加、删除或修改，并生成可视化的差异报告，突出显示这些更改。GroupDocs.Comparison 引擎将每个电子表格加载到内存中，评估公式、样式和工作表结构，然后渲染并排或叠加的 PDF/HTML 报告，开发者可以将其嵌入仪表盘或通过电子邮件发送给相关方。

为什么使用 Java 文档比较 API？

自动化生成差异报告可消除约 20 % 的人工审查遗漏错误，确保结果一致可靠。GroupDocs 提供对每一次修改的高精度检测、快速处理时间以及跨输出格式的统一样式，这些特性共同提升了财务、法律和内容管理团队的生产力。

支持的文件格式和功能

GroupDocs.Comparison for Java 支持 50+ 种输入和输出格式，包括：

  • 文档: DOCX, DOC, PDF, RTF, ODT
  • 电子表格: XLSX, XLS, CSV, ODS
  • 演示文稿: PPTX, PPT, ODP
  • 文本: TXT, HTML, XML, MD
  • 图像: PNG, JPEG, BMP, GIF（可视化比较）

高级功能包括受密码保护的文档处理、多语言检测、按文档类型自定义灵敏度、批量处理，以及云原生和本地部署选项。

前置条件和设置

系统要求

  1. Java Development Kit (JDK)： 8 或更高（推荐 JDK 11+）
  2. 构建工具： Maven 3.6+ 或 Gradle 6.0+
  3. 内存： 大文件最低 4 GB RAM
  4. 存储： 至少 500 MB 可用空间用于临时比较数据

Maven 配置

将 GroupDocs 仓库和依赖添加到 pom.xml 中，以确保获取官方发布版本：

<repositories>
    <repository>
        <id>repository.groupdocs.com</id>
        <name>GroupDocs Repository</name>
        <url>https://releases.groupdocs.com/comparison/java/</url>
    </repository>
</repositories>
<dependencies>
    <dependency>
        <groupId>com.groupdocs</groupId>
        <artifactId>groupdocs-comparison</artifactId>
        <version>25.2</version>
    </dependency>
</dependencies>

许可证设置

用于开发和测试

用于生产

在应用启动时初始化许可证：

// License initialization - do this once at application startup
com.groupdocs.comparison.License license = new com.groupdocs.comparison.License();
license.setLicense("path/to/your/license/file.lic");

Pro tip: 将许可证文件存放在 resources 文件夹中，并使用 getClass().getResourceAsStream() 加载，以实现可移植部署。

核心实现指南

功能 1：忽略页眉和页脚比较

setHeaderFootersComparison 方法禁用对页眉和页脚内容的比较，防止无关差异出现在 diff 中。

为何重要： 页眉页脚通常包含时间戳或页码，这些在不同版本之间会变化，但并非实质内容。跳过它们可降低噪声并加快处理速度。

真实场景： 两份合同草稿的页脚生成日期不同；您只关心条款的变更。

import com.groupdocs.comparison.Comparer;
import com.groupdocs.comparison.options.CompareOptions;
import java.io.FileOutputStream;

public class IgnoreHeaderFooterExample {
    public static void main(String[] args) throws Exception {
        String outputFileName = "YOUR_OUTPUT_DIRECTORY/IgnoreHeaderFooter_result.docx";

        try (OutputStream resultStream = new FileOutputStream(outputFileName);
             Comparer comparer = new Comparer("YOUR_DOCUMENT_DIRECTORY/source_with_footer.docx")) {

            comparer.add("YOUR_DOCUMENT_DIRECTORY/target_with_footer.docx");

            // Set comparison options to ignore headers and footers
            CompareOptions compareOptions = new CompareOptions.Builder()
                    .setHeaderFootersComparison(false)
                    .build();

            final Path resultPath = comparer.compare(resultStream, new SaveOptions(), compareOptions);
        }
    }
}

关键收益： 更清晰的差异结果、更少的误报以及因省略这些部分而提升的执行速度。

功能 2：设置输出纸张大小以生成专业报告

PaperSize 枚举定义了生成的 PDF 将使用的标准页面尺寸。

业务背景： 法务团队经常需要特定纸张大小的可打印比较报告，以用于法院提交或客户交付。

使用方法： 在 CompareOptions 中使用 PaperSize 枚举来定义目标尺寸。

import com.groupdocs.comparison.Comparer;
import com.groupdocs.comparison.options.CompareOptions;
import com.groupdocs.comparison.options.enums.PaperSize;

public class SetOutputPaperSizeExample {
    public static void main(String[] args) throws Exception {
        String outputFileName = "YOUR_OUTPUT_DIRECTORY/SetOutputPaperSize_result.docx";

        try (OutputStream resultStream = new FileOutputStream(outputFileName);
             Comparer comparer = new Comparer("YOUR_DOCUMENT_DIRECTORY/source_word.docx")) {

            comparer.add("YOUR_DOCUMENT_DIRECTORY/target1_word.docx");

            // Set the paper size to A6
            CompareOptions compareOptions = new CompareOptions.Builder()
                    .setPaperSize(PaperSize.A6)
                    .build();

            final Path resultPath = comparer.compare(resultStream, compareOptions);
        }
    }
}

支持的尺寸包括 A0‑A10、Letter、Legal、Tabloid 以及自定义尺寸。欧洲客户可选 A4，美国合作伙伴可选 Letter。

功能 3：微调比较灵敏度

setSensitivityOfComparison 方法调整比较引擎评估更改的粒度，从重大结构编辑到单字符差异均可控制。

挑战： 不同文档类别需要不同的粒度。法律合同要求字符级精度，营销文案可能只需段落级更改。

灵敏度尺度 (0‑100)：

  • 0‑25： 仅重大更改（段落添加/删除）
  • 26‑50： 中等更改（句子编辑）
  • 51‑75： 详细更改（单词级）
  • 76‑100： 细粒度更改（字符级）
import com.groupdocs.comparison.Comparer;
import com.groupdocs.comparison.options.CompareOptions;

public class AdjustComparisonSensitivityExample {
    public static void main(String[] args) throws Exception {
        String outputFileName = "YOUR_OUTPUT_DIRECTORY/AdjustComparisonSensitivity_result.docx";

        try (OutputStream resultStream = new FileOutputStream(outputFileName);
             Comparer comparer = new Comparer("YOUR_DOCUMENT_DIRECTORY/source_word.docx")) {

            comparer.add("YOUR_DOCUMENT_DIRECTORY/target1_word.docx");

            // Set sensitivity to 100 for maximum detail
            CompareOptions compareOptions = new CompareOptions.Builder()
                    .setSensitivityOfComparison(100)
                    .build();

            final Path resultPath = comparer.compare(resultStream, compareOptions);
        }
    }
}

最佳实践设置： 法律文档 90‑100，营销内容 40‑60，技术规格 70‑80。

功能 4：自定义更改样式以提升可视化沟通

StyleSettings 对象允许为插入、删除和修改的内容定义颜色、字体、边框等视觉提示。

为何自定义样式重要： 默认高亮可能与企业品牌或可访问性指南冲突。定制颜色、字体和边框可使差异一目了然。

示例： 删除使用红色背景，插入使用绿色背景，修改使用蓝色背景。

import com.groupdocs.comparison.Comparer;
import com.groupdocs.comparison.options.CompareOptions;
import com.groupdocs.comparison.options.save.SaveOptions;
import com.groupdocs.comparison.options.style.StyleSettings;

import java.awt.Color;
import java.io.FileInputStream;
import java.io.FileOutputStream;
import java.io.InputStream;
import java.io.OutputStream;

public class CustomizeChangesStylesStreamExample {
    public static void main(String[] args) throws Exception {
        String outputFileName = "YOUR_OUTPUT_DIRECTORY/CustomizeChangesStylesStream_result.docx";

        try (InputStream sourceFile = new FileInputStream("YOUR_DOCUMENT_DIRECTORY/source_word.docx");
             InputStream targetFile = new FileInputStream("YOUR_DOCUMENT_DIRECTORY/target1_word.docx");
             OutputStream resultStream = new FileOutputStream(outputFileName);
             Comparer comparer = new Comparer(sourceFile)) {

            comparer.add(targetFile);

            // Customize change styles for professional appearance
            StyleSettings insertedStyle = new StyleSettings();
            insertedStyle.setHighlightColor(Color.GREEN); // Green for additions
            StyleSettings deletedStyle = new StyleSettings();
            deletedStyle.setHighlightColor(Color.RED); // Red for deletions
            StyleSettings changedStyle = new StyleSettings();
            changedStyle.setHighlightColor(Color.BLUE); // Blue for modifications

            CompareOptions compareOptions = new CompareOptions.Builder()
                    .setInsertedItemStyle(insertedStyle)
                    .setDeletedItemStyle(deletedStyle)
                    .setChangedItemStyle(changedStyle)
                    .build();

            final Path resultPath = comparer.compare(resultStream, compareOptions);
        }
    }
}

高级选项还可修改字体粗细、大小、背景不透明度、边框样式以及删除线行为。

如何在比较报告中使用 Java 设置纸张大小

Comparer 是负责文档比较操作的核心类。使用源工作簿加载 Comparer 实例，配置 CompareOptions 对象，并通过 setPaperSize 使用所需的 PaperSize 枚举值。此单一设置决定生成 PDF 的页面尺寸，确保打印时无需手动缩放即可正确输出。

import com.groupdocs.comparison.Comparer;
import com.groupdocs.comparison.options.CompareOptions;
import com.groupdocs.comparison.options.enums.PaperSize;

public class SetOutputPaperSizeExample {
    public static void main(String[] args) throws Exception {
        String outputFileName = "YOUR_OUTPUT_DIRECTORY/SetOutputPaperSize_result.docx";

        try (OutputStream resultStream = new FileOutputStream(outputFileName);
             Comparer comparer = new Comparer("YOUR_DOCUMENT_DIRECTORY/source_word.docx")) {

            comparer.add("YOUR_DOCUMENT_DIRECTORY/target1_word.docx");

            // Set the paper size to A6
            CompareOptions compareOptions = new CompareOptions.Builder()
                    .setPaperSize(PaperSize.A6)
                    .build();

            final Path resultPath = comparer.compare(resultStream, compareOptions);
        }
    }
}

您可以将此设置与自定义页边距和方向标志结合，生成符合组织文档提交规范的布局，始终保证专业外观。

常见问题与故障排除

大文档的内存管理

问题： 比较大于 50 MB 的文件时出现 OutOfMemoryError。
解决方案： 增加 JVM 堆内存 (-Xmx8g) 并启用流式模式。

# Increase heap size for large document processing
java -Xmx4g -XX:MaxMetaspaceSize=512m YourComparisonApp

处理损坏或受密码保护的文件

当 API 遇到未提供密码的加密文档时会抛出 PasswordRequiredException。

问题： 对受锁定文档的比较失败。
预防措施： 在构造 Comparer 时提供密码，并捕获 PasswordRequiredException。

// Check document accessibility before comparison
try {
    Comparer comparer = new Comparer(sourceFile, "password123");
    // Document loaded successfully, proceed with comparison
} catch (PasswordRequiredException ex) {
    // Handle password‑protected documents
    log.error("Document requires password: " + sourceFile);
} catch (CorruptedFileException ex) {
    // Handle corrupted files gracefully
    log.error("File corruption detected: " + sourceFile);
}

批量处理的性能优化

挑战： 高效处理 100+ 文档对。
解决方案： 使用固定大小的线程池，将每个比较作为独立任务提交。

ExecutorService executor = Executors.newFixedThreadPool(4);
List<Future<ComparisonResult>> futures = new ArrayList<>();

for (DocumentPair pair : documentPairs) {
    futures.add(executor.submit(() -> compareDocuments(pair)));
}

// Wait for all comparisons to complete
for (Future<ComparisonResult> future : futures) {
    ComparisonResult result = future.get();
    // Process results
}
executor.shutdown();

特定格式问题

  • 扫描的 PDF： 在比较前进行 OCR 预处理。
  • Word 文档： 禁用已有的“修订”功能以避免错误的差异。
  • 嵌入对象： 单独提取并比较以确保准确性。

最佳实践与性能技巧

1. 文档预处理

在比较前剥离不必要的元数据并统一字体，以提升速度和准确性。

// Example preprocessing workflow
public void preprocessDocument(String filePath) {
    // Remove comments and tracked changes
    // Standardize formatting
    // Extract text‑only version for pure content comparison
}

2. 最佳配置文件

为每种文档类型（法律、营销、技术）创建可复用的 CompareOptions 预设，并在流水线中重复使用。

public class ComparisonProfiles {
    public static CompareOptions getLegalDocumentProfile() {
        return new CompareOptions.Builder()
                .setSensitivityOfComparison(95)
                .setHeaderFootersComparison(false)
                .setShowRevisions(true)
                .build();
    }
    
    public static CompareOptions getMarketingContentProfile() {
        return new CompareOptions.Builder()
                .setSensitivityOfComparison(45)
                .setIgnoreFormatting(true)
                .setFocusOnContent(true)
                .build();
    }
}

3. 强健的错误处理与日志记录

ComparisonException 表示比较过程中的失败并提供详细诊断信息。将比较调用包装在 try‑catch 块中，记录 ComparisonException 细节，并在需要时回退到安全默认值。

public ComparisonResult safeCompareDocuments(String source, String target) {
    try {
        return performComparison(source, target);
    } catch (Exception ex) {
        logger.error("Comparison failed for {} vs {}: {}", source, target, ex.getMessage());
        return ComparisonResult.failure(ex.getMessage());
    }
}

4. 缓存与智能复用

  • 为相同文件对缓存差异结果。
  • 保存文档指纹（哈希）以跳过未更改的文件。
  • 对非关键比较使用异步队列以保持 UI 响应。

实际集成场景

场景 1：自动化合同审查流水线

@Service
public class ContractReviewService {
    
    public void processContractRevision(String originalContract, String revisedContract) {
        CompareOptions legalOptions = ComparisonProfiles.getLegalDocumentProfile();
        
        try (Comparer comparer = new Comparer(originalContract)) {
            comparer.add(revisedContract);
            Path result = comparer.compare(generateOutputPath(), legalOptions);
            
            // Send comparison report to legal team
            emailService.sendComparisonReport(result, legalTeamEmails);
            
            // Log changes for audit trail
            auditService.logDocumentChanges(extractChanges(result));
        }
    }
}

场景 2：内容管理系统集成

@RestController
public class DocumentComparisonController {
    
    @PostMapping("/api/documents/compare")
    public ResponseEntity<ComparisonReport> compareDocuments(
            @RequestParam("source") MultipartFile source,
            @RequestParam("target") MultipartFile target,
            @RequestParam(value = "sensitivity", defaultValue = "75") int sensitivity) {
        
        CompareOptions options = new CompareOptions.Builder()
                .setSensitivityOfComparison(sensitivity)
                .build();
                
        ComparisonReport report = documentComparisonService.compare(source, target, options);
        return ResponseEntity.ok(report);
    }
}

常见问题

Q: 在 GroupDocs for Java 中可以忽略页眉和页脚吗？
A: 可以，在 CompareOptions 上调用 setHeaderFootersComparison(false) 即可，这会从差异中移除动态的页眉/页脚噪声。

Q: 如何在 Java 中使用 GroupDocs 设置输出纸张大小？
A: 在 CompareOptions 中使用 setPaperSize(PaperSize.A6)（或其他枚举值），即可生成所选尺寸的可打印 PDF。

Q: 是否可以针对不同文档类型微调比较灵敏度？
A: 当然。对法律合同使用 setSensitivityOfComparison(85)，对营销草稿使用 setSensitivityOfComparison(45)，以控制粒度。

Q: 能否自定义插入、删除和修改文本的样式？
A: 可以。为每种更改类型创建 StyleSettings 实例，设置颜色、字体或边框后再传入 CompareOptions。

Q: 开始使用 GroupDocs Comparison for Java 需要哪些前置条件？
A: 需要 JDK 8+（推荐 JDK 11+），Maven 3.6+ 或 Gradle 6.0+，至少 4 GB RAM，以及有效的 GroupDocs 许可证（提供免费试用）。

Q: 如何处理受密码保护的文档？
A: 在构造 Comparer 时将密码作为第二参数传入，例如 new Comparer(sourceFile, "myPassword")。捕获 PasswordRequiredException 以优雅处理错误。

Q: GroupDocs.Comparison for Java 支持哪些文件格式？
A: 超过 50 种格式，包括 DOCX、PDF、XLSX、PPTX、TXT、HTML、XML 以及常见图像类型（PNG、JPEG）。API 会自动检测格式，亦可显式指定以提升批处理性能。

结论

通过使用 GroupDocs.Comparison for Java，您可以自动化比较 Excel 工作簿以及所有受支持格式的繁琐任务，实现精准、快速且一致的结果。将本指南中的代码片段和最佳实践融入 CI/CD 流水线、文档管理系统或自定义审计工具，即可获得可衡量的生产力提升。

最后更新： 2026-11-01
测试环境： GroupDocs.Comparison 25.2 for Java
作者： GroupDocs

// Use streaming for memory efficiency
try (Comparer comparer = new Comparer(sourceStream)) {
    // Process in chunks for very large documents
    CompareOptions options = new CompareOptions.Builder()
            .setMemoryOptimization(true) // Enable memory optimization
            .build();
}

相关教程