在 Apache POI 中，直接对合并单元格（CellRangeAddress）应用边框时，若遍历整个区域并逐个设置单元格样式，会导致边框重复渲染、内部线条冗余或样式丢失；正确做法是仅对合并区域的外围边界设置边框，并确保该样式不覆盖原有字体、对齐等文本属性。
在 apache poi 中，直接对合并单元格（cellrangeaddress）应用边框时，若遍历整个区域并逐个设置单元格样式，会导致边框重复渲染、内部线条冗余或样式丢失；正确做法是仅对合并区域的**外围边界**设置边框，并确保该样式**不覆盖原有字体、对齐等文本属性**。
为合并单元格添加清晰、完整的边框是 Apache POI 表格导出中的常见需求，但极易因误用 CellStyle.cloneStyleFrom() 或错误遍历单元格而破坏原有文本格式（如字体、颜色、对齐方式）。关键在于：边框样式必须精准作用于合并区域的四周边界，而非每个内部单元格。
✅ 正确实现步骤
-
创建专用边框样式（保留原样式核心属性）
不要使用cloneStyleFrom()后再覆盖全部边框——这会重置所有未显式设置的属性（如字体、填充、对齐）。应基于原始样式仅增强边框：
public CellStyle createBorderedMergedStyle(CellStyle baseStyle, Workbook workbook) {
CellStyle borderStyle = workbook.createCellStyle();
// 复制关键文本属性（推荐显式复制，避免隐式丢失）
borderStyle.setFont(baseStyle.getFont());
borderStyle.setAlignment(baseStyle.getAlignment());
borderStyle.setVerticalAlignment(baseStyle.getVerticalAlignment());
borderStyle.setDataFormat(baseStyle.getDataFormat());
borderStyle.setFillPattern(baseStyle.getFillPattern());
borderStyle.setFillForegroundColor(baseStyle.getFillForegroundColor());
borderStyle.setFillBackgroundColor(baseStyle.getFillBackgroundColor());
// 仅设置外围边框（中等粗细）
borderStyle.setBorderTop(BorderStyle.MEDIUM);
borderStyle.setBorderLeft(BorderStyle.MEDIUM);
borderStyle.setBorderBottom(BorderStyle.MEDIUM);
borderStyle.setBorderRight(BorderStyle.MEDIUM);
return borderStyle;
}⚠️ 注意：
HSSFCellStyle.BORDER_MEDIUM已过时，请使用BorderStyle.MEDIUM（适用于 XSSF/HSSF）；同时Workbook接口统一支持，无需区分HSSFWorkbook/XSSFWorkbook。
-
仅对合并区域的「外框单元格」应用样式
合并单元格（如CellRangeAddress(1,1,4,8)）占据第1行、第4–8列（共5列），其有效边框仅存在于：- 上边框 → 第1行，第4–8列（top row）
- 下边框 → 第1行，第4–8列（bottom row，因单行合并，上下重合）
- 左边框 → 第1行，第4列（left column）
- 右边框 → 第1行，第8列（right column）
因此只需设置这9个单元格（1行 × 5列，但左右+上下共9个边界点）的样式即可，绝不可遍历整张表（如
rowIndex ）：
Apache Superset Dashboard and SQL Exploration Skill下载Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。
CellRangeAddress mergedRegion = new CellRangeAddress(1, 1, 4, 8);
CellStyle borderedStyle = createBorderedMergedStyle(css, workbook);
// 设置上边框（第1行，列4~8）
for (int c = mergedRegion.getFirstColumn(); c <= mergedRegion.getLastColumn(); c++) {
Cell cell = getOrCreateCell(sheet, mergedRegion.getFirstRow(), c);
cell.setCellStyle(borderedStyle);
}
// 设置左边框（第4列，行1→1，已覆盖）
// 设置右边框（第8列，行1→1，已覆盖）
// 设置下边框（同上边框，因单行合并，无需重复）辅助方法 getOrCreateCell 确保单元格存在：
private Cell getOrCreateCell(Sheet sheet, int rowIdx, int colIdx) {
Row row = sheet.getRow(rowIdx);
if (row == null) row = sheet.createRow(rowIdx);
Cell cell = row.getCell(colIdx);
if (cell == null) cell = row.createCell(colIdx);
return cell;
}-
应用样式前，先执行合并
必须在调用sheet.addMergedRegion(mergedRegion)之后，再设置边框样式；否则部分单元格可能尚未被 POI 内部识别为“属于合并区域”，导致样式失效。
sheet.addMergedRegion(mergedRegion); Cell topLeftCell = getOrCreateCell(sheet, mergedRegion.getFirstRow(), mergedRegion.getFirstColumn()); topLeftCell.setCellStyle(borderedStyle); // 设置左上角单元格样式即生效（POI 自动关联合并区域）
✅ 最佳实践：只需设置合并区域左上角单元格（即
getCell(firstRow, firstColumn)）的样式，POI 会自动将该样式应用于整个合并视觉区域（前提是合并已提交）。
? 总结与避坑指南
- ❌ 错误：遍历整行整列（如
rowIndex ）强行设样式 → 导致性能浪费、样式冲突、内部虚线残留； - ❌ 错误：
cloneStyleFrom()后未恢复字体/对齐等 → 文本格式丢失； - ✅ 正确：显式复制必要属性 + 仅设外围边界 + 合并后设置左上角单元格样式；
- ✅ 兼容性：统一使用
BorderStyle.*和HorizontalAlignment.*枚举，适配.xls与.xlsx； - ? 调试建议：导出后用 Excel 打开 → 右键单元格 → 「设置单元格格式」→ 「边框」页查看实际应用效果。
遵循以上方法，即可稳定、干净地为任意 CellRangeAddress 合并区域添加专业级边框，同时完整保留原有文本样式。
