如何使用Apache POI设置Excel单元格值且保留原有背景色

问题分析 #

你遇到的情况是：设置单元格值后原本的背景色丢失，尝试先保存样式再重新设置也无效。核心原因大概率是单元格样式的继承/创建逻辑出了问题——要么是新创建的单元格没继承原有行/列的背景样式，要么是你获取的CellStyle并非实际生效的样式（比如单元格继承了列样式，但cell.getCellStyle()只返回默认样式）。

解决方案 #

1. 正确获取/创建单元格（关键修复getCell方法）

如果你的getCell方法会在单元格不存在时创建新单元格，务必让新单元格继承行/列的样式，而非使用默认样式：

private Cell getCell(Sheet sheet, String cellAddress) {
    // 解析单元格地址（示例：A1转成列号0、行号0）
    CellReference cellRef = new CellReference(cellAddress);
    int rowNum = cellRef.getRow();
    int colNum = cellRef.getCol();

    Row row = sheet.getRow(rowNum);
    if (row == null) {
        row = sheet.createRow(rowNum);
        // 如果行不存在，可先设置行的默认样式（匹配工作簿的背景色配置）
        CellStyle rowStyle = sheet.getWorkbook().createCellStyle();
        rowStyle.setFillForegroundColor(IndexedColors.GREEN.getIndex());
        rowStyle.setFillPattern(FillPatternType.SOLID_FOREGROUND);
        row.setRowStyle(rowStyle);
    }

    Cell cell = row.getCell(colNum);
    if (cell == null) {
        cell = row.createCell(colNum);
        // 新单元格继承行的样式，而非默认样式
        cell.setCellStyle(row.getRowStyle());
    }
    return cell;
}

2. 无需额外重置样式

cell.setCellValue()本身不会修改单元格的现有样式，正常情况下直接设置值即可保留背景色：

Cell cell = getCell(sheet, cellAddress);
cell.setCellValue("test3");

3. 针对继承列样式的场景

如果背景色是设置在列上的（而非单元格或行），需要直接获取列样式应用：

Cell cell = getCell(sheet, cellAddress);
// 获取单元格所在列的样式
Column column = sheet.getColumn(cell.getColumnIndex());
CellStyle columnStyle = column.getCellStyle();
cell.setCellStyle(columnStyle);
cell.setCellValue("test3");

原有代码失效原因 #

你尝试保存样式再重置的逻辑之所以丢失背景色，是因为cell.getCellStyle()返回的是单元格自身的样式——如果单元格原本没有单独设置样式，而是继承行/列的样式，这个方法会返回工作簿的默认样式（无背景色），重置后自然覆盖了原本的继承样式。

内容的提问来源于stack exchange，提问作者Michał Mańkowski