Excel JavaScript API自定义公式返回FormattedNumberCellValue显示#####问题

单元格显示#####通常由以下几种原因导致，对应解决方案如下：

1. 列宽不足以容纳格式化后的数值 #

这是最常见的原因。格式化后的数值字符串长度超过了当前单元格列宽，Excel会用#####代替显示。

• 手动调整对应列的宽度，或者通过API自动设置列宽：

  await Excel.run(async (context) => {
    const sheet = context.workbook.worksheets.getActiveWorksheet();
    const cell = sheet.getActiveCell();
    cell.format.autofitColumns();
    await context.sync();
  });
  

2. 确保basicValue是有效的数值 #

如果value转换后是NaN（非数字），即使设置了格式也会显示异常。在构造响应前先校验数值有效性：

const numValue = Number(value);
if (isNaN(numValue)) {
  // 返回错误提示或默认值，比如0
  return {
    type: Excel.CellValueType.formattedNumber,
    basicValue: 0,
    numberFormat: '#,##0.00'
  };
} else {
  return {
    type: Excel.CellValueType.formattedNumber,
    basicValue: numValue,
    numberFormat: '#,##0.00'
  };
}

3. 确认格式字符串与数值匹配 #

如果数值是极大或极小的数，#,##0.00格式可能无法正常显示，可根据数值范围调整格式：

• 对于极大数，改用科学计数法格式：0.00E+00
• 对于负数，确保格式支持负号显示，比如#,##0.00;[Red]-#,##0.00

4. 验证自定义公式的返回结构 #

确保返回的对象完全符合Excel JS API要求：

• type必须是Excel.CellValueType.formattedNumber枚举值，注意枚举的拼写和大小写（API中枚举是大小写敏感的）
• 确保返回的对象被正确包裹在[[formattedResponse]]标记中，没有语法错误

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