本文详解在 apache poi 中为合并单元格（cellrangeaddress）精准添加完整边框的正确方法，避免样式覆盖、重复赋值和边界错位问题，并提供可直接运行的代码示例。
本文详解在 apache poi 中为合并单元格（cellrangeaddress）精准添加完整边框的正确方法，避免样式覆盖、重复赋值和边界错位问题，并提供可直接运行的代码示例。
在 Apache POI 中，为合并单元格（如 CellRangeAddress(1, 1, 4, 8)）添加边框是一个常见但易出错的操作。关键误区在于：不能简单地为合并区域内的所有单元格统一设置边框样式——因为合并单元格仅由左上角单元格（即起始单元格）承载内容与样式，其余被合并的单元格逻辑上已不存在（POI 不存储其独立样式）。若遍历整个区域并逐个调用 setCellStyle()，不仅无效，还会破坏原有文本格式（如字体、对齐），甚至导致边框显示不全或仅部分可见。
✅ 正确做法是：仅为目标合并区域的“外围边界”单元格设置对应方向的边框，即：
- 顶部行（
firstRow）的所有列 → 设置BORDER_TOP - 底部行（
lastRow）的所有列 → 设置BORDER_BOTTOM - 左侧列（
firstCol）的所有行 → 设置BORDER_LEFT - 右侧列（
lastCol）的所有行 → 设置BORDER_RIGHT
同时，必须复用原始文本样式（如字体、颜色、对齐），再叠加边框属性，而非 cloneStyleFrom() 后粗暴覆盖全部单元格。
以下为推荐实现（兼容 XSSF/SSF，以 HSSF 为例）：
Apache Superset Dashboard and SQL Exploration Skill
下载
Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。
public CellStyle createBorderedMergedStyle(Workbook workbook, CellStyle baseStyle) {
CellStyle borderStyle = workbook.createCellStyle();
// 复用基础样式（字体、对齐、填充等）
borderStyle.cloneStyleFrom(baseStyle);
// 仅添加边框（使用 MEDIUM 确保清晰可见）
borderStyle.setBorderTop(BorderStyle.MEDIUM);
borderStyle.setBorderBottom(BorderStyle.MEDIUM);
borderStyle.setBorderLeft(BorderStyle.MEDIUM);
borderStyle.setBorderRight(BorderStyle.MEDIUM);
return borderStyle;
}
// 应用到指定合并区域（例如：第1行，第4~8列）
CellRangeAddress range = new CellRangeAddress(1, 1, 4, 8);
CellStyle borderedStyle = createBorderedMergedStyle(workbook, css); // css 是你的原始文本样式
// ✅ 关键：只设置边框区域的「外框单元格」，不遍历内部
int firstRow = range.getFirstRow();
int lastRow = range.getLastRow();
int firstCol = range.getFirstColumn();
int lastCol = range.getLastColumn();
Sheet sheet = workbook.getSheetAt(0);
// 设置顶部边框（整行，从 firstCol 到 lastCol）
for (int c = firstCol; c <p>⚠️ 注意事项：</p>
-
不要遍历整个矩形区域（如
0–13 行 × 0–13 列）：这会污染非合并区域样式，且对已合并单元格的内部单元格设样式无意义； -
确保
CellRangeAddress已实际应用：调用sheet.addMergedRegion(range)是前提（否则只是逻辑地址，无合并效果）； -
样式复用优先于克隆：
cloneStyleFrom()在旧版 HSSF 中存在潜在 bug，建议显式复制关键属性，或直接使用XSSFWorkbook（推荐）； - 若需多组不同样式的合并区域（如
css和cs），请分别为其创建独立CellStyle实例（POI 要求样式对象不可跨区域混用）。
通过上述方式，你将获得轮廓清晰、样式一致、完全适配合并逻辑的边框效果，彻底解决“只有部分显示边框”或“文本格式丢失”的问题。
