Java 查找并替换 Excel 中的数据：详细教程

在日常的数据处理工作中，Excel 文件无疑是最常见的载体之一。无论是业务报表、数据统计还是配置清单，我们都可能面临在大量 Excel 数据中进行查找和替换的需求。面对庞杂的数据，手动操作不仅效率低下，还极易出错。本文将深入探讨如何借助 Java 语言和强大的 Spire.XLS for Java 库，实现高效、精准的 Excel 数据查找与替换，解决开发者和企业在数据处理上的痛点。通过本文，你将学会如何在 Java 应用中自动化处理 Excel 文件的查找替换任务。

Spire.XLS for Java 简介与环境搭建

Spire.XLS for Java 是一个专业的 Java Excel API，它允许开发者在不依赖 Microsoft Office 的情况下，创建、读取、编辑、转换和打印 Excel 文档。该库功能全面，支持多种 Excel 版本（.xls、.xlsx、.xlsm、.xltm 等），提供了丰富的 API，可以处理单元格、行、列、工作表、图表、图片、公式、批注等几乎所有 Excel 对象。对于需要进行 Excel 数据处理的 Java 项目来说，它是一个非常实用且强大的工具。

依赖配置

要在你的 Java 项目中使用 Spire.XLS for Java，你需要将其作为 Maven 依赖引入。

Maven 依赖：

  <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.xls</artifactId>
        <version>15.9.1</version>
    </dependency>
</dependencies>

在整个 Excel 工作表中查找并替换数据

在很多场景下，我们需要对整个 Excel 工作表中的特定文本进行查找并统一替换。Spire.XLS for Java 提供了简洁的 API 来实现这一功能。

以下是一个完整的 Java 代码示例，演示如何在整个工作表中查找所有出现的 "总计" 并替换为 "合计"。

import com.spire.xls.CellRange;
import com.spire.xls.ExcelVersion;
import com.spire.xls.Workbook;
import com.spire.xls.Worksheet;

import java.awt.Color;

public class ReplaceData {
    public static void main(String[] args) {
        // 初始化Workbook类的实例
        Workbook workbook = new Workbook();
        // 加载Excel文件
        workbook.loadFromFile("示例文档.xlsx");

        // 获取第一个工作表
        Worksheet worksheet = workbook.getWorksheets().get(0);

        // 在工作表中查找具有特定字符串值的单元格
        CellRange[] cells = worksheet.findAllString("总计", true, true);

        // 遍历找到的单元格
        for (CellRange cell : cells) {
            // 将单元格的值替换为另一个值
            cell.setText("合计");
            // 设置单元格的背景色
            cell.getStyle().setColor(Color.YELLOW);
        }

        // 保存结果文件
        workbook.saveToFile("替换数据.xlsx", ExcelVersion.Version2016);
        workbook.dispose();
    }
}

代码解析：

• workbook.loadFromFile("input.xlsx") ：加载指定路径的 Excel 文件。
• workbook.getWorksheets().get(0) ：获取工作簿中的第一个工作表。
• worksheet.findAllString("总计", true, true) ：这是核心的查找方法。它返回一个 CellRange 数组，每个 CellRange 对象代表一个包含目标字符串的单元格。第一个参数是目标字符串，第二个参数 true 表示查找时区分大小写，第三个参数 true 表示进行全字匹配。
• cell.setText("合计") ：替换单元格的文本内容。
• workbook.saveToFile(...) ：将修改后的工作簿保存到新文件。

在指定单元格范围内查找并替换数据

有时，我们只需要在 Excel 的特定区域（例如，某一列或某一区域）内进行查找和替换，而不是整个工作表。Spire.XLS for Java 也提供了灵活的方式来定义查找范围。

以下是一个示例，演示如何在指定单元格范围内（例如，A1:C12）查找所有 "Total" 并替换为 "Sum"。

import com.spire.xls.CellRange;
import com.spire.xls.ExcelVersion;
import com.spire.xls.Workbook;
import com.spire.xls.Worksheet;

import java.awt.Color;

public class ReplaceDataInCellRange {
    public static void main(String[] args) {
 
       // 初始化Workbook类的实例
        Workbook workbook = new Workbook();
    
    // 加载Excel文件
        workbook.loadFromFile("Test.xlsx");

        // 获取第一个工作表
        Worksheet worksheet = workbook.getWorksheets().get(0);

        // 获取特定单元格范围
        CellRange range = worksheet.getCellRange("A1:C12");

        //在单元格范围中查找具有特定值的单元格
     CellRange[] cells = range.findAllString("Total", true, true);

        // 遍历找到的单元格
        for (CellRange cell : cells) {
            // 将单元格的值替换为另一个值
            cell.setText("Sum");
            // 设置单元格的背景色
            cell.getStyle().setColor(Color.YELLOW);
        }

        // 将结果文件保存到特定位置
        workbook.saveToFile("替换单元格范围中的数据.xlsx", ExcelVersion.Version2016);
        workbook.dispose();
    }
}

代码解析：

• worksheet.getCellRange("A1:C12") ：这是定义查找范围的关键。它通过字符串形式指定一个单元格区域，并返回一个 CellRange 对象，后续的查找操作将仅限于此范围。
• range.findAllString("Total", true, true) ：与全局查找类似，但这里是在 CellRange 对象上调用 findAllString 方法，确保查找操作只在该指定范围内进行。第二个参数 true 表示区分大小写，第三个参数 true 表示全字匹配，这意味着只有单元格内容完全是 "Total" 的才会被匹配。

通过这种方式，你可以精确控制查找和替换的范围，避免误修改，提升数据处理的准确性和安全性。

结论

本文详细介绍了如何利用 Java 和 Spire.XLS for Java 库在 Excel 文件中进行高效的数据查找与替换。无论是对整个工作表进行全局替换，还是在特定单元格范围内进行精准操作，Spire.XLS for Java 都提供了直观且功能强大的 API。通过上述代码示例，开发者可以轻松地将这些功能集成到自己的 Java 应用程序中，自动化处理复杂的 Excel 数据任务。掌握这些技能，无疑将大大提升你在 Java 环境下处理 Excel 数据的能力，从而更好地应对企业级数据处理的挑战。