使用Office.js API计算内置数组函数遇问题，求解决方案

核心原因 #

Excel.Functions类的设计目标是处理单个标量值的函数计算，并不支持Excel原生的数组逐元素运算逻辑，因此直接传入数组参数会出现结果不符合预期的情况。

可行解决方案 #

1. 利用Excel原生数组公式求值（推荐）

通过临时单元格写入数组公式，借助Excel内置计算引擎获取正确的数组结果，这是最可靠的方式，无需自行实现函数逻辑：

await Excel.run(async (context) => {
  // 创建临时工作表用于计算
  const tempSheet = context.workbook.worksheets.add("TempCalc");
  // 获取源数据区域
  const sourceRange = context.workbook.worksheets.getActiveWorksheet().getRange("A1:A4");
  sourceRange.load("values");
  await context.sync();

  // 写入数组公式到对应临时区域
  const calcRange = tempSheet.getRange(`B1:B${sourceRange.rowCount}`);
  calcRange.arrayFormula = `=5*${sourceRange.address}`;
  calcRange.load("values");
  await context.sync();

  // 获取计算后的数组结果
  const result = calcRange.values;
  // 清理临时工作表
  tempSheet.delete();
  console.log(result); // 输出 [[5],[10],[15],[20]]
});

2. 封装逐元素运算逻辑

如果不想依赖临时单元格，可以针对需要的函数封装数组遍历逻辑，调用Excel.Functions处理单个元素：

// 示例：实现支持数组的PRODUCT运算（针对5*A1:A4场景）
async function arrayProduct(factor, arrayRange) {
  return await Excel.run(async (context) => {
    arrayRange.load("values");
    await context.sync();
    
    const result = [];
    for (const row of arrayRange.values) {
      const cellValue = row[0];
      // 调用Excel.Functions计算单个元素的乘积
      const singleResult = Excel.Functions.product([factor, cellValue]);
      result.push([singleResult]);
    }
    return result;
  });
}

官方API现状与规划 #

目前Excel JavaScript API中没有专门替代Excel.Functions的数组化计算类。微软在Office开发路线图中提及了数组运算增强的长期规划，但暂无明确的发布时间节点。

内容的提问来源于stack exchange，提问作者David van Deursen