You need to enable JavaScript to run this app. Java实现Excel第一列含指定值的匹配行提取操作
优惠活动
大模型
产品
解决方案
定价
更多

Java实现Excel第一列含指定值的匹配行提取操作

Java实现Excel第一列匹配提取整行数据

常用依赖引入(Maven)

以Apache POI作为Excel解析核心库,适配.xls(2003版)和.xlsx(2007+版)两种格式,pom.xml依赖配置:

<dependencies>
    <!-- 支持xls格式解析 -->
    <dependency>
        <groupId>org.apache.poi</groupId>
        <artifactId>poi</artifactId>
        <version>5.2.5</version>
    </dependency>
    <!-- 支持xlsx格式解析 -->
    <dependency>
        <groupId>org.apache.poi</groupId>
        <artifactId>poi-ooxml</artifactId>
        <version>5.2.5</version>
    </dependency>
</dependencies>

核心实现逻辑

  • 识别目标Excel文件的后缀格式,构建对应的Workbook实例
  • 定位到需要检索的工作表(默认取第一个工作表,可按需指定Sheet名称/索引)
  • 从工作表第一行开始逐行遍历,仅读取每行*第一列(索引为0的列)*的单元格值
  • 将单元格值和预设的匹配值做规则比对,匹配成功则提取当前行全部列的单元格值,完成目标行的精准查询与提取
  • 遍历完成后返回所有匹配成功的行数据

工具类核心代码

import org.apache.poi.ss.usermodel.*;
import java.io.File;
import java.io.FileInputStream;
import java.io.IOException;
import java.util.ArrayList;
import java.util.List;

public class ExcelRowExtractor {
    /**
     * 按第一列匹配值提取整行数据
     * @param filePath 目标Excel文件绝对路径
     * @param matchValue 第一列需要匹配的目标值
     * @param sheetIndex 要检索的工作表索引,从0开始
     * @return 匹配成功的整行数据列表,每个元素对应一行的所有单元格值
     */
    public static List<List<String>> extractRowByFirstColumnMatch(String filePath, String matchValue, int sheetIndex) throws IOException {
        List<List<String>> result = new ArrayList<>();
        // 加载Excel文件
        try (FileInputStream fis = new FileInputStream(new File(filePath));
             Workbook workbook = WorkbookFactory.create(fis)) {
            // 获取指定工作表
            Sheet sheet = workbook.getSheetAt(sheetIndex);
            // 逐行遍历
            for (Row row : sheet) {
                // 跳过空行
                if (row == null) continue;
                // 获取第一列单元格(索引0)
                Cell firstColCell = row.getCell(0);
                if (firstColCell == null) continue;
                // 统一转为字符串做匹配,兼容数字、字符串等单元格类型
                String cellValue = getCellStringValue(firstColCell);
                // 匹配规则可按需调整:比如trim()、忽略大小写、模糊匹配等
                if (cellValue.trim().equals(matchValue.trim())) {
                    // 匹配成功,提取整行数据
                    List<String> rowData = new ArrayList<>();
                    // 遍历当前行所有列
                    for (int colIndex = 0; colIndex < row.getLastCellNum(); colIndex++) {
                        Cell cell = row.getCell(colIndex);
                        rowData.add(cell == null ? "" : getCellStringValue(cell));
                    }
                    result.add(rowData);
                }
            }
        }
        return result;
    }

    /**
     * 兼容不同单元格类型,统一返回字符串值
     */
    private static String getCellStringValue(Cell cell) {
        CellType cellType = cell.getCellType();
        if (cellType == CellType.STRING) {
            return cell.getStringCellValue();
        } else if (cellType == CellType.NUMERIC) {
            // 数字类型可根据业务需求调整日期格式转换逻辑
            return String.valueOf(cell.getNumericCellValue());
        } else if (cellType == CellType.BOOLEAN) {
            return String.valueOf(cell.getBooleanCellValue());
        } else if (cellType == CellType.FORMULA) {
            // 公式单元格取计算后的值
            return cell.getStringCellValue();
        }
        return "";
    }
}

实现注意事项

  • 处理超大Excel文件时,避免一次性加载全量文件到内存,可切换为POI的流式只读模式,防止出现OOM异常
  • 匹配逻辑可根据业务需求调整,仅需修改第一列单元格值的比对判断部分即可
  • 若第一列存在合并单元格,需要单独处理合并区域的取值逻辑,避免出现空值判断失效

内容的提问来源于stack exchange,提问作者Rafał Surdziel

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.06 10:15:07