如何在Excel Office Scripts主脚本中集成AVERAGEIFS函数？

你的问题出在几个关键细节上，直接修正方案如下：

核心错误点 #

1. 函数调用语法错误：Office Scripts中调用工作表函数的正确对象是workbook.functions（复数形式），不是workbook.function，这是触发类型错误的直接原因。
2. 异步操作缺失：Office Scripts基于Excel REST API，调用工作表函数需要用await获取异步结果（主函数本身已是async类型，满足要求）。
3. 数组未初始化：avgAvai仅声明类型但未初始化，直接执行push会抛出运行时错误。
4. 条件判断的赋值错误：usedRangeValues[rowIndex+1][15] = 0是赋值操作，不是相等判断，需改为===或==。

修正后的完整代码示例 #

async function main(workbook: ExcelScript.Workbook) {
  // 补充基础逻辑（假设你已自行获取相关变量，此处为示例）
  const worksheet = workbook.getActiveWorksheet();
  const usedRange = worksheet.getUsedRange();
  const usedRangeValues = usedRange.getValues();
  const rowCount = usedRange.getRowCount();

  // 初始化数组
  let avgAvai: number[] = [];

  for (let rowIndex = 3; rowIndex < rowCount; rowIndex++){
    // 修正条件判断的赋值错误
    if ((usedRangeValues[rowIndex][15] !== 0) && (usedRangeValues[rowIndex+1][15] === 0) ){
      // 调用AVERAGEIFS，使用正确的函数对象并await结果
      const avgResult = await workbook.functions.averageifs(
        worksheet.getRange("P:P"), // 计算平均值的目标范围
        worksheet.getRange("D:D"), // 条件匹配的范围
        usedRangeValues[rowIndex][3] // 匹配的条件值
      );
      // 处理函数返回结果（避免无匹配值时存入错误对象）
      if (!avgResult.isError) {
        avgAvai.push(avgResult.value as number);
      } else {
        // 可选：无匹配值时的默认处理，比如存入0或NaN
        avgAvai.push(0);
      }
    }
  }

  // 验证结果（可选）
  console.log(avgAvai);
}

额外优化提示 #

• 避免使用整列范围（如P:P），可改用实际数据范围（例如worksheet.getRange("P2:P" + rowCount)）来提升性能。
• 如果需要批量计算，也可以考虑先提取D列和P列的所有值，用JavaScript逻辑自行计算平均值，减少API调用次数，进一步优化效率。

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