本文介绍使用apache poi读取excel中既含公式又设为货币格式的单元格真实数值的方法，重点解决`getnumericcellvalue()`返回0、`evaluateformulacell()`报错及格式干扰等问题。
在使用 Apache POI 处理 Excel 文件时，若某单元格（如 F65）显示为货币格式（如 $1,234.56），但其实际内容是公式（如 =ROUND(G65*E65,2)），直接调用 cell.getNumericCellValue() 往往返回 0.0——这是因为该单元格当前 CellType 可能仍为 CELL_TYPE_FORMULA，且未经过公式求值；而手动修改公式字符串（如去掉等号再重设）不仅冗余，还会触发非法公式错误（如 "The specified formula '=ROUND(...)' starts with an equals sign which is not allowed"），因为 setCellFormula() 本身不接受开头的 =。
✅ 正确做法是：跳过手动干预公式字符串，交由 FormulaEvaluator 安全求值，并获取原始数值结果。以下是推荐的两步法：
✅ 方法一：使用 evaluator.evaluate() 获取计算后的数值（推荐）
FormulaEvaluator evaluator = workbook.getCreationHelper().createFormulaEvaluator();
CellValue cellValue = evaluator.evaluate(cell); // 返回 CellValue 对象，已执行计算
if (cellValue.getCellType() == CellType.NUMERIC) {
double result = cellValue.getNumberValue(); // 直接获取计算后的 double 值（如 1234.56）
System.out.println("公式计算结果: " + result);
}⚠️ 注意：evaluator.evaluate(cell) 不会修改单元格本身类型或内容，仅返回运行结果，安全无副作用，适用于只读场景。
✅ 方法二：强制刷新单元格类型后读取（需谨慎）
若后续逻辑依赖 cell.getNumericCellValue()，可先求值再刷新单元格状态：
FormulaEvaluator evaluator = workbook.getCreationHelper().createFormulaEvaluator();
evaluator.evaluateFormulaCell(cell); // 将公式计算结果写入单元格，并更新 CellType
// 此时 cell 的类型通常变为 CELL_TYPE_NUMERIC（POI 4.1.2+ 自动处理）
double value = cell.getNumericCellValue(); // 现在可安全调用
System.out.println("刷新后数值: " + value);? 提示：evaluateFormulaCell() 会修改单元格的缓存值和类型，适合需要统一后续处理逻辑的场景；但请确保 workbook 未被其他线程并发修改。
立即学习“Java免费学习笔记（深入）”；
❌ 避免的常见错误
- 不要手动 cell.setCellFormula(formula.substring(1))：setCellFormula() 要求传入不带 = 的纯公式表达式（如 "ROUND(G65*E65,2)"），且会覆盖原单元格内容；
- 不要先 setCellType(CellType.STRING) 再 getStringCellValue()：这会丢失数值语义，返回公式文本而非结果；
- 不要依赖 DataFormatter.formatCellValue(cell)：它仅按显示格式渲染，对公式单元格默认输出公式字符串而非结果。
? 总结
读取带公式的货币格式单元格，核心在于分离“公式求值”与“格式解析”：先用 FormulaEvaluator.evaluate() 获取准确数值，再按需做货币格式化（如 NumberFormat.getCurrencyInstance().format(result)）。无需修改单元格类型或公式内容，即可稳定、高效、安全地提取业务所需的真实数值。
