本文详解如何使用 Apache POI 生成支持正负值差异化着色的 Excel 柱状图，解决负值柱形默认空白、颜色失效等常见问题，涵盖 setInvertIfNegative(false) 强制启用填充、setCrossBetween(BETWEEN) 修正坐标轴对齐，以及手动设置填充色与高级负值反色方案。
本文详解如何使用 apache poi 生成支持正负值差异化着色的 excel 柱状图，解决负值柱形默认空白、颜色失效等常见问题，涵盖 `setinvertifnegative(false)` 强制启用填充、`setcrossbetween(between)` 修正坐标轴对齐，以及手动设置填充色与高级负值反色方案。
在使用 Apache POI（尤其是 XDDF API）绘制 Excel 柱状图（Bar/Column Chart）时，若数据包含负值（如 -5），默认行为常导致对应柱形“不可见”或显示为空白——这并非 Bug，而是 Excel 渲染逻辑与 POI 默认配置共同作用的结果：Excel 原生支持 invertIfNegative 属性，当启用时会自动将负值柱形颜色反转（通常为白色或透明），而 POI 新版本中该属性默认为 true，且未显式指定填充色时，负值区域便无法正常渲染。
✅ 关键修复三步法
1. 禁用自动反色：setInvertIfNegative(false)
必须显式关闭此开关，否则负值柱形将沿用“反色逻辑”，即使设置了主填充色也无效：
XDDFChartData.Series series1 = data.addSeries(months, values);
series1.setTitle("Month", null);
// ? 关键：禁用负值自动反色，确保统一填充生效
((XDDFBarChartData.Series) series1).setInvertIfNegative(false);
2. 设置坐标轴交叉方式：setCrossBetween(AxisCrossBetween.BETWEEN)
若省略此步，Excel 会将数值轴（Y 轴）与分类轴（X 轴）的交点设在类别中心点（MIDPOINT_CATEGORY），导致首尾柱形被截断一半。正确做法是让轴线交叉于类别之间，保证所有柱形完整显示：
XDDFValueAxis leftAxis = chart.createValueAxis(AxisPosition.LEFT);
leftAxis.setTitle("Area");
leftAxis.setCrosses(AxisCrosses.AUTO_ZERO); // 自动以 0 为基准线
leftAxis.setCrossBetween(AxisCrossBetween.BETWEEN); // ? 必须设置！
3. 显式指定填充色（推荐使用 PresetColor）
POI 不会为系列自动分配可靠填充色，需手动注入 XDDFSolidFillProperties。以下为封装好的工具方法，支持快速设置纯色填充：
private static void solidFillSeries(XDDFChartData data, int index, PresetColor color) {
XDDFSolidFillProperties fill = new XDDFSolidFillProperties(XDDFColor.from(color));
XDDFChartData.Series series = data.getSeries(index);
XDDFShapeProperties props = series.getShapeProperties();
if (props == null) props = new XDDFShapeProperties();
props.setFillProperties(fill);
series.setShapeProperties(props);
}
// 使用示例（主色设为蓝色）：
solidFillSeries(data, 0, PresetColor.BLUE);
? 进阶：为负值柱形单独指定颜色（Excel 2007+）
若需实现“正值蓝色、负值红色”的视觉区分（非简单禁用反色），可启用 invertIfNegative(true) 并注入自定义反色 XML 扩展（仅兼容较新 Excel 版本）：
static void setInvertedColor(XDDFBarChartData.Series series, String rgb) throws Exception {
String extXML = """
<ext uri="{6F2FDCE9-48DA-4B69-8628-5D25D57E5C99}" xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main" xmlns:c="http://schemas.openxmlformats.org/drawingml/2006/chart" xmlns:c14="http://schemas.microsoft.com/office/drawing/2007/8/2/chart"><invertsolidfillfmt><sppr><solidfill><srgbclr val="%s"></srgbclr></solidfill></sppr></invertsolidfillfmt></ext>
""".formatted(rgb);
org.openxmlformats.schemas.drawingml.x2006.chart.CTBarSer ctBarSer = series.getCTBarSer();
if (ctBarSer.isSetExtLst()) ctBarSer.unsetExtLst();
var extList = ctBarSer.addNewExtLst();
extList.set(org.apache.xmlbeans.XmlObject.Factory.parse(extXML));
}
// 在主逻辑中调用：
((XDDFBarChartData.Series) series1).setInvertIfNegative(true);
setInvertedColor(series1, "FF0000"); // 红色负值柱
⚠️ 注意：该扩展依赖 Excel 2007 及以上版本的私有命名空间，旧版 Excel（如 2003）或部分兼容性软件可能忽略此设置。
✅ 完整最佳实践要点总结
| 项目 | 推荐配置 | 说明 |
|---|---|---|
| invertIfNegative | false（默认不满足） | 避免负值柱形变透明/白色 |
| crossBetween | BETWEEN | 防止首尾柱形被截断 |
| 填充色 | 必须显式设置 | 使用 solidFillSeries(...) 或等效方式 |
| 图表类型 | BarDirection.COL（列图） | 更符合常规“柱状图”语义；若需横向条形图，改用 BAR |
| 文件路径 | 使用相对路径（如 "./chart.xlsx"） | 避免 Windows 绝对路径反斜杠转义问题 |
通过上述配置，即可稳定生成正负值均清晰可见、色彩可控的 Excel 柱状图，完美适配财务分析、盈亏对比、温度变化等典型业务场景。
