如何获取Apache POI中看似数值实为字符串的单元格原始值？

这种情况本质是Excel将你输入的1111,2222,3333识别为带自定义数字格式的数值（而非纯文本），POI读取时按数值类型处理，默认转换方式会丢失原始显示的逗号分隔规则。以下是可行的解决方法：

方法一：读取单元格自定义格式并格式化数值 #

Excel中显示的逗号是单元格格式的一部分，而非存储的实际内容。你可以提取单元格的自定义格式字符串，再用它格式化数值，还原原始显示效果：

import org.apache.poi.ss.usermodel.*;
import java.text.DecimalFormat;

public String getOriginalDisplayValue(Cell cell) {
    if (cell.getCellType() == CellType.NUMERIC) {
        CellStyle style = cell.getCellStyle();
        String formatStr = style.getDataFormatString();
        // 针对自定义逗号分隔格式（如"0,0,0"），直接用该格式格式化数值
        DecimalFormat df = new DecimalFormat(formatStr);
        return df.format(cell.getNumericCellValue());
    }
    // 其他类型按常规处理
    return new DataFormatter().formatCellValue(cell);
}

注意：如果格式字符串包含Excel特有的占位符（如[$-409]这类区域标识），需要先清理无关部分再创建DecimalFormat。

方法二：强制读取原始存储内容（仅适用于特定场景） #

如果单元格原本设为文本格式但被POI误判为数值，可尝试直接读取原始存储内容：

import org.apache.poi.xssf.usermodel.XSSFCell;

public String getRawTextValue(XSSFCell cell) {
    if (cell.getCellType() == CellType.NUMERIC) {
        // 仅XSSF支持直接获取单元格原始字符串
        return cell.getRawValue();
    }
    return cell.getStringCellValue();
}

此方法仅对“实际存储为文本但被Excel标记为数值”的场景有效；如果是自定义格式的数值，getRawValue()会返回纯数字字符串，仍需用方法一处理。

关键提示 #

• 从根源避免问题：若你控制Excel文件生成，建议提前将这类单元格设置为文本格式，避免Excel自动格式化导致POI类型识别偏差。
• 适配格式字符串：不同Excel版本生成的格式字符串可能存在差异，需根据实际情况调整格式解析逻辑，比如处理带区域代码的格式串。

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