Google Sheets自定义函数中如何调用内置函数？

直接在Google Apps Script（GAS）的JavaScript环境里写VLOOKUP()、SUM()这类表格内置函数是行不通的，因为GAS的JS运行环境不识别这些仅在表格公式里生效的函数。要实现这个需求，得通过Google Sheets的API间接调用内置函数，下面是具体的解决方法：

方法一：用临时单元格计算公式结果 #

针对你提供的vlookupPassthrough示例，修改后可运行的代码如下：

function vlookupPassthrough(searchKey, range, index, is_sorted=false) {
  const sheet = SpreadsheetApp.getActiveSheet();
  // 选一个不会干扰用户的临时单元格（这里用当前工作表最后一行的下一行第一列）
  const tempCell = sheet.getRange(sheet.getMaxRows() + 1, 1);
  // 处理字符串中的双引号，避免公式语法错误
  const escapedKey = typeof searchKey === 'string' ? searchKey.replace(/"/g, '""') : searchKey;
  // 构造VLOOKUP公式字符串，注意布尔值要转成大写的TRUE/FALSE
  const formula = `=VLOOKUP("${escapedKey}", ${range.getA1Notation()}, ${index}, ${is_sorted.toString().toUpperCase()})`;
  
  tempCell.setFormula(formula);
  const result = tempCell.getValue();
  // 清理临时单元格内容
  tempCell.clearContent();
  
  return result;
}

注意事项： #

• 临时单元格尽量选用户不会用到的位置，比如隐藏列、工作表末尾的空白行，避免影响用户操作
• 如果参数是字符串，必须转义其中的双引号（把"替换成""），否则会导致公式语法错误
• 布尔型参数要转换成大写的TRUE或FALSE，符合表格公式的语法要求

方法二：用evaluate()方法直接计算公式 #

如果不需要临时单元格，也可以用SpreadsheetApp.getActiveSpreadsheet().evaluate()方法直接计算公式字符串，示例如下：

function sumCustom(range) {
  const formula = `=SUM(${range.getA1Notation()})`;
  // 直接计算公式并获取结果
  const evaluation = SpreadsheetApp.getActiveSpreadsheet().evaluate(formula);
  return evaluation.getValue();
}

// 调用IF函数的示例
function ifCustom(condition, trueVal, falseVal) {
  const formula = `=IF(${condition}, "${trueVal}", "${falseVal}")`;
  const evaluation = SpreadsheetApp.getActiveSpreadsheet().evaluate(formula);
  return evaluation.getValue();
}

注意事项： #

• evaluate()方法会直接在当前表格环境中计算公式，结果和在单元格里输入公式一致
• 同样要注意参数的格式转换，比如字符串转义、布尔值大写等

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