POI生成Excel时数据格式点变逗号致显示异常的原因与解决

核心问题出在POI的数字格式解析依赖区域设置（Locale）。Excel自定义格式里的#.##0，其中.是「千位分隔符占位符」，不是字面意义的点。POI处理格式串时，会根据当前Locale自动替换占位符为对应区域的实际分隔符：

• 欧美Locale（比如Locale.US）：千位分隔符用逗号（,），小数点用点（.），所以POI会把格式里的.换成,
• 欧洲大陆Locale（比如德语区）：千位分隔符用点（.），小数点用逗号（,），这时候POI会保留格式里的.作为千位分隔符

你看到格式串被修改，就是因为POI默认用了欧美Locale，自动替换了分隔符占位符，导致格式逻辑反转，数值显示完全乱掉。

有两种靠谱的解决方式：

1. 指定目标区域的Locale #

创建单元格格式时，用对应Locale的DataFormat，让POI按目标区域的规则处理格式串：

// 示例：用德语区Locale（对应千位分隔符为点，小数点为逗号）
Locale targetLocale = new Locale("de", "DE");
DataFormat dataFormat = workbook.createDataFormat();
CellStyle cellStyle = workbook.createCellStyle();

// 设置自定义格式，POI会根据指定Locale解析占位符
cellStyle.setDataFormat(dataFormat.getFormat("_(* #.##0_);_(* (#.##0);_(* \"-\"??_);_(@_)"));
// 关键步骤：把CellStyle的Locale设为目标Locale
cellStyle.setLocale(targetLocale);

这样POI会按照德语区规则，把格式串里的.识别为千位分隔符占位符，最终生成的Excel格式串会保留.，数值就能显示成13.534.000。

2. 强制用原始格式字符串（绕过POI自动替换） #

如果不想依赖Locale，可以直接把格式串作为自定义格式ID设置，避免POI解析替换占位符：

DataFormat dataFormat = workbook.createDataFormat();
// 获取自定义格式ID（格式已存在就返回现有ID，不存在则创建新的）
short formatId = dataFormat.getFormat("_(* #.##0_);_(* (#.##0);_(* \"-\"??_);_(@_)");
CellStyle cellStyle = workbook.createCellStyle();
cellStyle.setDataFormat(formatId);

这种方式下，POI不会对格式串做任何修改，直接写入Excel，确保格式完全符合你的要求。

设置完格式后，可以用cellStyle.getDataFormatString()查看最终的格式串，确认是否和目标一致。如果显示的是_(* #.##0_);_(* (#.##0);_(* "-"??_);_(@_)，就说明设置成功了。

内容的提问来源于stack exchange，提问作者mcv