如何在Apache POI中实现VBA的Sheet.range()函数

嘿，刚上手Apache POI的话，确实会需要找VBA里常用功能的替代方案，我来给你拆解下怎么实现类似Sheet.range()的效果~

核心思路 #

VBA的Sheet.range()本质是定位一个单元格区域，在POI里没有直接同名的API，但可以通过几个类组合实现，核心是先确定区域的行/列范围，再遍历或操作这个范围内的单元格。

1. 解析单元格区域字符串（比如"A1:B5"） #

如果习惯用VBA里的字符串格式指定区域（比如Range("A1:C3")），可以用POI的AreaReference类来解析这个字符串，再获取区域的首尾单元格坐标：

// 假设你已经获取了Sheet对象（XSSFSheet或HSSFSheet）
AreaReference area = new AreaReference("A1:B5", SpreadsheetVersion.EXCEL2007);
CellReference topLeft = area.getFirstCell();
CellReference bottomRight = area.getLastCell();

// 转换为POI的索引（注意POI行/列从0开始，VBA从1开始）
int firstRow = topLeft.getRow();
int lastRow = bottomRight.getRow();
int firstCol = topLeft.getCol();
int lastCol = bottomRight.getCol();

接下来就可以遍历这个区域的所有单元格了：

for (int rowNum = firstRow; rowNum <= lastRow; rowNum++) {
    Row row = sheet.getRow(rowNum);
    if (row == null) continue; // 跳过空行（该行无任何单元格）
    for (int colNum = firstCol; colNum <= lastCol; colNum++) {
        Cell cell = row.getCell(colNum);
        if (cell == null) {
            // 如果是空白单元格，需要的话可以创建它
            cell = row.createCell(colNum);
        }
        // 这里处理单元格，比如获取值、设置样式等
        String cellValue = cell.getStringCellValue();
    }
}

2. 直接指定行/列范围（类似VBA的Range(Cells(1,1), Cells(5,2))） #

如果已经知道区域的首尾行号和列号，不用字符串解析的话，可以直接遍历：

// 比如对应VBA的Range(Cells(1,1), Cells(5,2))，POI里要转成0开始的索引
int startRow = 0; // VBA的1 → POI的0
int endRow = 4;   // VBA的5 → POI的4
int startCol = 0; // VBA的1 → POI的0
int endCol = 1;   // VBA的2 → POI的1

for (int rowNum = startRow; rowNum <= endRow; rowNum++) {
    Row row = sheet.getRow(rowNum);
    if (row == null) row = sheet.createRow(rowNum); // 主动创建空行（如果需要）
    for (int colNum = startCol; colNum <= endCol; colNum++) {
        Cell cell = row.getCell(colNum);
        if (cell == null) cell = row.createCell(colNum);
        // 处理单元格逻辑
    }
}

注意事项 #

• POI的行、列索引都是从0开始的，和VBA的1起始索引要注意转换；
• sheet.getRow(rowNum)可能返回null（当该行没有任何已创建的单元格时），根据需求决定是跳过还是主动创建；
• 如果需要对区域做批量样式设置，可以先创建好CellStyle对象，再遍历区域给每个单元格赋值样式。

内容的提问来源于stack exchange，提问作者Kuan