优化Google App Scripts数据校验脚本性能的技术问询

我是脚本新手，2小时前才接触脚本开发。从网上获取了一款用于本人参与的在线游戏工资记录录入系统的Google App Scripts校验脚本，目前该脚本执行耗时约6-8秒，希望能进一步优化其运行速度。曾尝试了解批量操作相关内容，但因缺乏基础无法理解，特此寻求帮助。

原脚本如下：

//Function to validate the entry made by user in Add Pay
function validateEntry() {
  //declare a variable and set the reference of active google sheet
  var myGoogleSheet = SpreadsheetApp.getActiveSpreadsheet();
  var shAddPay = myGoogleSheet.getSheetByName("Add Pay");
  var ui = SpreadsheetApp.getUi();

  //Validating Pay Slot (GMT)
  if (shAddPay.getRange("C3").isBlank() == true) {
    ui.alert("Please enter Pay Slot.");
    shAddPay.getRange("C3").activate();
    return false;
  }

  //Validating Amount
  if (shAddPay.getRange("C5").isBlank() == true) {
    ui.alert("Please enter Amount.");
    shAddPay.getRange("C5").activate();
    return false;

  }

  //Validating Employee Paid
  if (shAddPay.getRange("C7").isBlank() == true) {
    ui.alert("Please enter Employee Paid.");
    shAddPay.getRange("C7").activate();
    return false;
  }
  return true
}

优化方案 #

• 核心优化点：减少与Google表格服务器的通信次数，原脚本每次校验都单独调用getRange()和isBlank()，这是导致耗时的主要原因。改为一次性读取所有需要校验的单元格数据，本地完成空值判断。

优化后的脚本：

function validateEntry() {
  const myGoogleSheet = SpreadsheetApp.getActiveSpreadsheet();
  const shAddPay = myGoogleSheet.getSheetByName("Add Pay");
  const ui = SpreadsheetApp.getUi();
  
  // 一次性读取C3、C5、C7所在的单元格范围数据
  const cellValues = shAddPay.getRange("C3:C7").getValues().flat();
  // 对应提取三个需要校验的值
  const paySlot = cellValues[0];
  const amount = cellValues[2];
  const employeePaid = cellValues[4];

  // 校验工资时段
  if (!paySlot) {
    ui.alert("请填写工资时段（GMT）。");
    shAddPay.getRange("C3").activate();
    return false;
  }

  // 校验金额
  if (!amount) {
    ui.alert("请填写金额。");
    shAddPay.getRange("C5").activate();
    return false;
  }

  // 校验已支付员工
  if (!employeePaid) {
    ui.alert("请填写已支付员工。");
    shAddPay.getRange("C7").activate();
    return false;
  }

  return true;
}

优化说明 #

1. 仅通过一次getRange().getValues()调用获取所有需要的单元格数据，大幅降低服务器通信次数，直接压缩执行耗时。
2. 本地存储单元格值后进行空值判断，避免重复发起API请求。
3. 替换isBlank() == true为更简洁的!value，逻辑完全一致。
4. 将提示文本改为中文，适配使用场景。

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