Apache POI中如何为合并单元格添加完整的上下左右边框？

你遇到的问题本质是：Apache POI的合并单元格只是视觉上的合并，底层每个单元格仍是独立对象。只有左上角单元格的内容会被展示，但边框样式是每个单元格各自的属性，所以仅设置首单元格样式的话，其他单元格没有边框，就会出现只有首格有边框的情况。

要让合并区域显示完整的上下左右边框，核心是给合并范围内的所有单元格都设置对应的边框样式，具体实现步骤如下：

1. 创建带边框的单元格样式 #

先定义一个包含完整边框和居中对齐的样式（可根据需求调整边框粗细）：

Workbook workbook = new XSSFWorkbook();
// 创建边框样式
CellStyle borderCellStyle = workbook.createCellStyle();
// 设置上下左右边框为细实线
borderCellStyle.setBorderTop(BorderStyle.THIN);
borderCellStyle.setBorderBottom(BorderStyle.THIN);
borderCellStyle.setBorderLeft(BorderStyle.THIN);
borderCellStyle.setBorderRight(BorderStyle.THIN);
// 设置内容居中
borderCellStyle.setAlignment(HorizontalAlignment.CENTER);
borderCellStyle.setVerticalAlignment(VerticalAlignment.CENTER);

2. 定义合并区域并添加到工作表 #

指定要合并的行和列范围（示例为第0行的0-2列）：

Sheet sheet = workbook.createSheet("测试页");
// 定义合并区域：起始行，结束行，起始列，结束列
CellRangeAddress mergedRegion = new CellRangeAddress(0, 0, 0, 2);
sheet.addMergedRegion(mergedRegion);

3. 遍历合并区域，给所有单元格应用样式 #

必须遍历合并范围内的每一个单元格，为它们设置边框样式，确保每个单元格都有对应的边框：

// 遍历合并区域的行
for (int rowIdx = mergedRegion.getFirstRow(); rowIdx <= mergedRegion.getLastRow(); rowIdx++) {
    Row row = sheet.getRow(rowIdx);
    if (row == null) {
        row = sheet.createRow(rowIdx);
    }
    // 遍历合并区域的列
    for (int colIdx = mergedRegion.getFirstColumn(); colIdx <= mergedRegion.getLastColumn(); colIdx++) {
        Cell cell = row.getCell(colIdx);
        if (cell == null) {
            cell = row.createCell(colIdx);
        }
        // 应用边框样式
        cell.setCellStyle(borderCellStyle);
    }
}

4. 给首单元格设置内容 #

最后在合并区域的左上角单元格写入内容即可：

Cell firstCell = sheet.getRow(0).getCell(0);
firstCell.setCellValue("as");

补充说明 #

如果追求更精细的边框控制（比如避免中间单元格左右边框重复），可以针对不同位置的单元格设置不同边框：

• 首列单元格：保留左、上、下边框
• 中间列单元格：保留上、下边框
• 末列单元格：保留右、上、下边框
  但直接给所有单元格设置完整边框的方案已经能满足绝大多数场景，且实现简单。

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