如何在Google Apps Script中调用Google Sheets自定义命名函数？

问题根源 #

Google Apps Script的运行环境与Google Sheets的公式环境相互独立，因此无法直接在Script代码中调用Sheets的自定义命名函数（如你的POINTS）或内置函数（如SUM、COUNTIF），必须通过特定方法桥接两个环境。

解决方案 #

方案一：将自定义函数逻辑迁移到Apps Script（推荐，高效）

把你在Sheets中定义的POINTS函数逻辑，直接写成Apps Script的函数，这样summing可以直接调用，无需依赖Sheets公式环境：

1. 编写Script版的POINTS函数：

function POINTS_SCRIPT(cell) {
  // 替换为你原POINTS自定义函数的逻辑
  // 示例：根据单元格数值计算积分
  const cellValue = cell.getValue();
  if (cellValue >= 90) return 10;
  else if (cellValue >= 80) return 8;
  else if (cellValue >= 70) return 6;
  else return 0;
}

2. 修改summing函数调用该Script函数：

function summing(row, startCol, endCol) {
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  const sheet = ss.getActiveSheet();
  let sum = 0;
  
  for (let i = startCol; i <= endCol; i++) {
    const targetCell = sheet.getRange(row, i);
    sum += POINTS_SCRIPT(targetCell);
  }
  return sum;
}

方案二：在Script中调用Sheets的自定义/内置函数（适合不愿迁移逻辑的场景）

使用SpreadsheetApp.evaluate()方法执行Sheets公式字符串，获取计算结果：

function summing(row, startCol, endCol) {
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  const sheet = ss.getActiveSheet();
  let sum = 0;
  
  for (let i = startCol; i <= endCol; i++) {
    // 获取目标单元格的A1表示法（如B5）
    const cellA1 = sheet.getRange(row, i).getA1Notation();
    // 构造POINTS公式并执行
    const formulaResult = ss.evaluate(`=POINTS(${cellA1})`);
    sum += formulaResult.getValue();
  }
  return sum;
}

注意：此方法每次循环都要执行一次公式，大范围遍历效率较低，小范围场景适用。

调用内置函数的通用方法 #

如果需要调用SUM、COUNTIF等内置函数，同样用evaluate()构造公式即可，示例：

// 计算A1:A10的和
const sumResult = ss.evaluate(`=SUM(A1:A10)`).getValue();
// 统计B列中大于80的单元格数量
const countResult = ss.evaluate(`=COUNTIF(B:B, ">80")`).getValue();

内容的提问来源于stack exchange，提问作者Spanish Student Here