使用C# NPOI填充.xls模板时格式不生效的问题解决方法

我之前在项目里也踩过NPOI这个格式生效的坑，跟你遇到的情况一模一样——明明模板里设置好了格式，写入值后却不显示，非得点一下单元格确认才出来。其实问题根源在于单元格数据类型和模板格式不匹配，下面给你拆解原因和解决方案：

问题原因 #

你的模板单元格预先设置了数值/日期这类格式，但你用SetCellValue(string)直接写入字符串时，NPOI会把单元格类型设为String。Excel的格式规则是：只有当单元格数据类型和格式类型匹配时，才会自动应用格式。所以此时字符串类型的单元格不会触发数值格式的渲染，只有当你编辑单元格时，Excel自动把字符串转成数值，才会套用格式。

解决方案 #

核心思路是让写入的数据类型和模板格式匹配，而不是直接写入字符串。具体分两种情况处理：

1. 模板是数值/日期格式（最常见场景） #

把字符串转换为对应的数据类型后再写入，同时保留原有样式：

var cr = new CellReference(cellAndValue[i, 0]);
var row = sheet?.GetRow(cr.Row);
var cell = row?.GetCell(cr.Col);
var prevStyle = cell.CellStyle;

// 根据模板格式选择转换类型：数值用double，日期用DateTime
if (double.TryParse(cellAndValue[i, 0], out double numericValue))
{
    // 写入数值类型，让Excel识别并应用模板格式
    cell.SetCellValue(numericValue);
}
// 如果是日期格式，替换成DateTime转换
// else if (DateTime.TryParse(cellAndValue[i, 0], out DateTime dateValue))
// {
//     cell.SetCellValue(dateValue);
// }
else
{
    // 转换失败时再回退到字符串写入
    cell.SetCellValue(cellAndValue[i, 0]);
}

// 重新应用模板原有样式
cell.CellStyle = prevStyle;

2. 必须保留字符串类型但要应用格式 #

如果你的业务场景要求单元格是文本类型，但要显示数值格式（比如带千分位的文本），可以手动设置单元格类型为数值，写入后再调整样式：

var cr = new CellReference(cellAndValue[i, 0]);
var row = sheet?.GetRow(cr.Row);
var cell = row?.GetCell(cr.Col);
var prevStyle = cell.CellStyle;

// 先将单元格类型设为数值
cell.SetCellType(CellType.Numeric);
// 写入转换后的数值
if (double.TryParse(cellAndValue[i, 0], out double numericValue))
{
    cell.SetCellValue(numericValue);
}
// 应用原有样式
cell.CellStyle = prevStyle;

为什么你之前的方法没用？ #

你之前保存了原有样式，但忽略了单元格类型的变化——SetCellValue(string)会强制把单元格类型改成String，而模板的格式是针对Numeric类型的，所以即使重新应用样式，类型不匹配也无法触发格式渲染。

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