Hssfcellstyle方法如何设置单元格居中对齐？

Question

在使用 Apache POI 操作 Excel 文件时，开发者常通过 `HSSFCellStyle` 设置单元格样式，但部分用户反馈无法正确实现文本居中对齐。常见问题是：尽管调用了 `setAlignment(HorizontalAlignment.CENTER)` 和 `setVerticalAlignment(VerticalAlignment.CENTER)`，导出的 Excel 单元格内容仍默认左对齐。这通常源于未将样式对象赋值给单元格，或重复创建 CellStyle 导致样式未生效。此外，在 HSSFWorkbook 中，CellStyle 数量受限，需复用样式对象。如何正确使用 `HSSFCellStyle` 实现水平与垂直居中对齐？

Answer 1

Apache POI 中 HSSFCellStyle 居中对齐的深度解析与最佳实践

1. 问题背景：为何居中设置无效？

在使用 Apache POI 操作 Excel 文件时，开发者常通过 HSSFCellStyle 设置单元格样式。尽管调用了 setAlignment(HorizontalAlignment.CENTER) 和 setVerticalAlignment(VerticalAlignment.CENTER)，但导出的 Excel 单元格内容仍默认左对齐。这种现象让许多开发者困惑。

根本原因通常包括：

• 未将创建的 CellStyle 对象应用到目标单元格
• 重复创建多个 CellStyle 实例，导致超出 HSSFWorkbook 的样式数量限制（256个）
• 忽略了工作簿级别对样式的管理机制

2. 样式未生效的常见错误代码示例

Workbook workbook = new HSSFWorkbook();
Sheet sheet = workbook.createSheet("Test");
Row row = sheet.createRow(0);
Cell cell = row.createCell(0);
cell.setCellValue("居中文本");

// 错误：创建了样式但未赋值给单元格
HSSFCellStyle style = (HSSFCellStyle) workbook.createCellStyle();
style.setAlignment(HorizontalAlignment.CENTER);
style.setVerticalAlignment(VerticalAlignment.CENTER);

// 缺少关键步骤：cell.setCellStyle(style);

上述代码中，虽然定义了居中样式，但由于未通过 cell.setCellStyle(style) 将其绑定到单元格，因此样式不会生效。

3. 正确实现水平与垂直居中的标准流程

1. 从 Workbook 获取或创建 CellStyle 实例
2. 配置对齐方式：setAlignment 与 setVerticalAlignment
3. 将样式对象通过 setCellStyle() 方法应用到目标单元格
4. 确保在整个导出过程中复用已创建的样式对象

4. 完整正确示例代码

Workbook workbook = new HSSFWorkbook();
Sheet sheet = workbook.createSheet("居中示例");
Row row = sheet.createRow(0);
Cell cell = row.createCell(0);
cell.setCellValue("居中文本");

// 正确做法：创建并配置样式
HSSFCellStyle centerStyle = (HSSFCellStyle) workbook.createCellStyle();
centerStyle.setAlignment(HorizontalAlignment.CENTER);
centerStyle.setVerticalAlignment(VerticalAlignment.CENTER);

// 关键步骤：将样式赋值给单元格
cell.setCellStyle(centerStyle);

// 写入文件验证结果
FileOutputStream out = new FileOutputStream("centered.xls");
workbook.write(out);
workbook.close();
out.close();

5. 样式复用的重要性与性能影响

在 HSSFWorkbook（对应 .xls 格式）中，每个工作簿最多支持 256 个不同的 CellStyle 对象。若每次写入都新建样式，极易触发 IllegalStateException: The maximum number of cell styles was exceeded 异常。

策略	是否推荐	说明
每次创建新样式	❌ 不推荐	易超限，浪费内存
全局缓存复用样式	✅ 推荐	提升性能，避免资源耗尽
按需创建并池化	✅ 高级推荐	适用于复杂报表场景

6. 使用 Map 缓存优化样式复用

为避免重复创建相同样式的对象，可采用 Map 结构缓存常用样式：

Map<String, HSSFCellStyle> styleCache = new HashMap<>();

public HSSFCellStyle getCenterStyle(Workbook workbook) {
    String key = "CENTER";
    if (!styleCache.containsKey(key)) {
        HSSFCellStyle style = (HSSFCellStyle) workbook.createCellStyle();
        style.setAlignment(HorizontalAlignment.CENTER);
        style.setVerticalAlignment(VerticalAlignment.CENTER);
        styleCache.put(key, style);
    }
    return styleCache.get(key);
}

7. XSSF 与 HSSF 的兼容性差异分析

对于现代项目，建议优先使用 XSSFWorkbook（.xlsx 格式），其最大样式数限制为 64,000，远高于 HSSF 的 256。但仍建议复用样式以减少内存开销。

两种格式的核心区别如下表所示：

特性	HSSFWorkbook (.xls)	XSSFWorkbook (.xlsx)
最大 CellStyle 数	256	64,000
内存占用	较低	较高
推荐用途	旧系统兼容	新项目首选
居中设置方式	一致	一致

8. Mermaid 流程图：样式应用逻辑判断

graph TD
    A[开始] --> B{是否已有居中样式?}
    B -- 是 --> C[从缓存获取样式]
    B -- 否 --> D[创建新样式并配置居中]
    D --> E[存入缓存]
    C --> F[应用样式到单元格]
    E --> F
    F --> G[完成写入]
    

9. 高级技巧：构建通用样式工厂类

在大型系统中，建议封装一个 ExcelStyleFactory 类统一管理所有常用样式：

public class ExcelStyleFactory {
    private final Workbook workbook;
    private final Map<String, CellStyle> cache;

    public ExcelStyleFactory(Workbook wb) {
        this.workbook = wb;
        this.cache = new ConcurrentHashMap<>();
    }

    public CellStyle getCenterStyle() {
        return cache.computeIfAbsent("CENTER", k -> {
            CellStyle s = workbook.createCellStyle();
            s.setAlignment(HorizontalAlignment.CENTER);
            s.setVerticalAlignment(VerticalAlignment.CENTER);
            return s;
        });
    }
}

10. 调试建议与常见陷阱排查清单

• 确认是否调用了 cell.setCellStyle(style)
• 检查是否因异常捕获不当导致样式初始化失败
• 使用 POI 提供的 workbook.getNumCellStyles() 监控当前样式数量
• 避免在循环内创建相同样式的 CellStyle
• 注意 cloneStyleFrom() 方法可用于继承样式属性
• 测试导出文件时使用 Excel 手动查看单元格格式是否正确
• 考虑使用模板引擎如 EasyExcel 或 SXSSF 提升大规模数据处理效率
• 日志记录关键样式创建行为以便追踪问题
• 单元格内容过长可能导致视觉上“未居中”，需结合自动换行设置
• 设置 setWrapText(true) 可改善多行文本居中效果