ExcelJS 4.3.0导出Excel时编辑栏与单元格精度不一致问题求助

问题核心 #

升级ExcelJS到4.3.0后，导出的Excel文件出现两种异常：

• 带自定义格式函数的列：单元格显示格式化后的精度（如3.15），但编辑栏仍显示原始完整精度（如3.154）
• 无自定义格式的百分比列：单元格显示1,000.00%，编辑栏却显示1000%（丢失千分符和小数位）

原因分析 #

Excel的单元格显示与编辑栏一致性依赖两个核心：

1. 单元格数值本身必须匹配显示的精度，不能保留原始高精度数值
2. 正确设置numFmt（数字格式），让Excel识别数字类型并统一应用格式

之前的方案要么仅设置numFmt但保留原始数值，要么把数值转为字符串破坏了数字格式属性，导致显示不一致。

解决方案 #

修改格式化函数，同时处理数值精度和数字格式，确保数值与格式完全匹配：

public formatCellsForExport(cell: any): void {
  // 处理带自定义格式函数的列
  if (typeof cell.gridCell.column.format === 'function') {
    const formatted = cell.gridCell.column.format(cell.gridCell.value);
    if (formatted) {
      // 移除千分符后解析为数字，确保数值精度与显示一致
      const parsedValue = parseFloat(formatted.replace(/,/g, ''));
      if (!isNaN(parsedValue)) {
        cell.excelCell.value = parsedValue;
      } else {
        // 非数字场景直接使用格式化后的字符串
        cell.excelCell.value = formatted;
      }

      // 根据格式化结果设置对应的数字格式
      if (formatted.includes(',')) {
        cell.excelCell.numFmt = '#,##0.00';
      } else if (formatted.includes('.')) {
        cell.excelCell.numFmt = '0.00';
      }
    }
  }

  // 处理百分比列（无论是否有自定义格式）
  if (cell.gridCell.column.displayFormatString === 'percent') {
    let rawValue = cell.gridCell.value;
    // 处理字符串类型的百分比值（如"1000%"）
    if (typeof rawValue === 'string') {
      rawValue = parseFloat(rawValue.replace('%', '')) / 100;
    }
    // 四舍五入到四位小数，确保转换为百分比后保留两位小数精度
    const formattedValue = Number(rawValue.toFixed(4));
    cell.excelCell.value = formattedValue;
    cell.excelCell.numFmt = '#,##0.00%';
  }
}

关键说明 #

1. 自定义格式列：
   • 将格式化后的字符串解析为数字，确保数值精度与单元格显示完全一致
   • 同步设置对应numFmt，让Excel识别为数字类型，编辑栏会遵循格式显示
2. 百分比列：
   • 先将数值转换为Excel百分比格式的基数（如1000%对应数值10）
   • 对数值做精度处理，确保转换为百分比后显示两位小数
   • 设置numFmt为#,##0.00%，强制显示千分符和两位小数，此时编辑栏与单元格显示完全统一

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