如何使用Apache POI设置单元格灰色背景色？

Question

**如何使用Apache POI设置单元格灰色背景色？** 在使用Apache POI进行Excel文件操作时，常需要对单元格样式进行自定义，比如设置背景颜色。那么，如何使用Apache POI为单元格设置灰色背景色呢？ 首先，需创建或获取一个`CellStyle`对象，并使用`setFillForegroundColor()`方法设置前景色（即填充颜色）。对于灰色，可选择内置的`IndexedColors.GREY_25_PERCENT`或其他灰阶颜色。同时，必须调用`setFillPattern()`方法设置填充模式，如`FillPatternType.SOLID_FOREGROUND`，以确保颜色生效。 注意，在POI中，颜色是有限的，尤其是在XSSF（Excel 2007+）与HSSF（Excel 2003）之间存在差异。是否需要自定义RGB颜色？是否适用于合并单元格？这些都可能影响最终实现方式。

Answer 1

如何使用Apache POI设置单元格灰色背景色？

在Java开发中，Apache POI 是处理 Microsoft Office 文档的常用工具包，尤其是在 Excel 文件操作方面。对于需要对 Excel 单元格进行样式定制的开发者来说，设置单元格的背景颜色是一个常见需求。

一、基础：创建并应用一个简单的灰色背景样式

Apache POI 提供了 CellStyle 类用于定义单元格样式。要设置灰色背景，需调用 setFillForegroundColor() 方法，并指定填充模式为 SOLID_FOREGROUND。

Workbook workbook = new XSSFWorkbook(); // 或 HSSFWorkbook 用于 .xls 格式
Sheet sheet = workbook.createSheet("Gray Cells");
Row row = sheet.createRow(0);
Cell cell = row.createCell(0);
cell.setCellValue("灰色背景");

CellStyle style = workbook.createCellStyle();
style.setFillForegroundColor(IndexedColors.GREY_25_PERCENT.getIndex());
style.setFillPattern(FillPatternType.SOLID_FOREGROUND);

cell.setCellStyle(style);

上述代码适用于 XSSFWorkbook（即 .xlsx 文件），若使用 HSSFWorkbook（即 .xls 文件），部分常量名称可能略有不同。

二、进阶：选择不同的灰色调与自定义RGB颜色

POI 提供了多种预定义的灰色调，例如：

• IndexedColors.GREY_25_PERCENT
• IndexedColors.GREY_40_PERCENT
• IndexedColors.GREY_50_PERCENT
• IndexedColors.GREY_80_PERCENT

若需要更精确的颜色控制，可使用 RGB 自定义颜色：

XSSFCellStyle customStyle = (XSSFCellStyle) workbook.createCellStyle();
XSSFFont font = (XSSFFont) workbook.createFont();
font.setColor(IndexedColors.WHITE.getIndex());

customStyle.setFillForegroundColor(new XSSFColor(new java.awt.Color(128, 128, 128), null));
customStyle.setFillPattern(FillPatternType.SOLID_FOREGROUND);
customStyle.setFont(font);

注意：该方式仅适用于 XSSF 模块，HSSF 不支持 RGB 自定义颜色。

三、高级：合并单元格时的应用与样式继承问题

当涉及合并单元格时，只需将样式应用于合并区域中的每个单元格即可，而非整个合并后的区域自动继承样式。

步骤	说明
1. 创建合并区域	使用 sheet.addMergedRegion(new CellRangeAddress(startRow, endRow, startCol, endCol))
2. 遍历区域内所有单元格	逐一设置样式
3. 应用样式	为每个单元格设置 CellStyle

此外，如果希望保持样式一致性，建议将样式对象缓存或复用，避免重复创建。

四、扩展：兼容性与性能优化

以下是 Apache POI 在不同格式下的颜色支持对比：

格式	是否支持 RGB 自定义颜色	内置颜色数量	适用场景
HSSF (.xls)	否	约60种	旧系统兼容
XSSF (.xlsx)	是	无限（RGB）	现代办公文档

为了提高性能，避免频繁创建 CellStyle 对象，建议使用 Map 缓存已创建的样式，如下所示：

Map styleCache = new HashMap<>();

String key = "gray-25";
if (!styleCache.containsKey(key)) {
    CellStyle grayStyle = workbook.createCellStyle();
    grayStyle.setFillForegroundColor(IndexedColors.GREY_25_PERCENT.getIndex());
    grayStyle.setFillPattern(FillPatternType.SOLID_FOREGROUND);
    styleCache.put(key, grayStyle);
}
cell.setCellStyle(styleCache.get(key));

这样可以有效减少内存开销，提升大规模 Excel 文件导出效率。