Apps Script执行缓慢排查：无关数据为何影响性能？

测试工作簿中脚本执行仅需15秒，但在数据更多的最终工作簿中耗时超4分钟，偶尔还会超时。尽管脚本在两个工作簿中引用的工作表完全一致，但工作簿大小仍严重影响了脚本性能，请问忽略了哪些要点？

原脚本代码 #

///--------------------------------------------------------------------------///

function Update_Pricing() {
  Browser.msgBox('Message Header'
    ,'message here'
  , Browser.Buttons.OK);  

// Source workbook 
  const wb = SpreadsheetApp.getActiveSpreadsheet();                                                                              

// Dashboard
  const dash = wb.getSheetByName("Dashboard");
// Finds the Dashboard value to update as Incomplete as the dashboard values occasional move rows
  const dashvalue1 = dash.getRange(1, 2, dash.getLastRow(), 1).getValues().flat().indexOf("Competitor Information Upload") + 1; // **Dashboard lookup value
  const dashrange1 = dash.getRange(dashvalue1, 4);                                                                              // Dashboard date stamp column
  dashrange1.setValue("Incomplete");
  SpreadsheetApp.flush();
  SpreadsheetApp.getActive().toast('Dashboard Updated','🔄 Update',20);

// Retrieve Spreadsheet ID from cell
  const settings = wb.getSheetByName("Ref_Config");                                                                                     // Settings page with ID reference
  const ref_ID = settings.getRange(1, 3, settings.getLastRow(), 1).getValues().flat().indexOf("Khg - Competitor Pricing Workbook") + 1; // **Settings page lookup value
  const srcSpreadsheetId = settings.getRange(ref_ID,4).getValue();                                                                      // Source workbook ID reference
  SpreadsheetApp.flush();
  SpreadsheetApp.getActive().toast('Spreadsheet ID retrieved, loading data','🔄 Update',60);
  Logger.log(srcSpreadsheetId)

  const srcwb = SpreadsheetApp.openById(srcSpreadsheetId);
  const srcsheet = srcwb.getSheetByName("Summary");                                                           // **Source workbook sheet name
  const srcdata = srcsheet.getRange(2,1,srcsheet.getLastRow()-1,10).getValues()                               // **Get values (row,columnm,optNumRows,OptNumColumnss)
  SpreadsheetApp.flush();
  SpreadsheetApp.getActive().toast('Source values retrieved','🔄 Update',40);
}

核心问题与优化方向 #

• 频繁调用SpreadsheetApp.flush()：每次小操作后强制同步电子表格状态，在大型工作簿中会产生巨大的性能开销。仅当后续操作依赖当前操作的即时结果时才需要调用，你当前场景中大部分flush()都可以移除。
• 整列范围读取的低效性：getRange(1, 2, dash.getLastRow(), 1).getValues()会读取B列从第1行到getLastRow()的所有数据，而大型工作簿中getLastRow()可能因隐藏行、格式残留返回远大于实际数据的行数，导致读取大量空数据。改用createTextFinder()直接定位目标文本，无需读取整列数据。
• 工作簿的隐性负载：即使脚本引用的工作表数据一致，大型工作簿可能存在隐藏工作表、复杂条件格式、公式链、残留对象或其他脚本触发器，这些都会增加后台处理开销，拖慢脚本执行速度。
• 跨工作簿连接的开销：打开外部工作簿在大型环境中延迟更高，尤其是目标工作簿本身也较大时。可以考虑缓存外部ID，减少重复连接的开销。
• Browser.msgBox()的阻塞：开头的弹窗会暂停脚本执行直到用户交互，在无人值守场景下会额外增加等待时间，建议替换为非阻塞的toast提示。

优化后的脚本示例 #

///--------------------------------------------------------------------------///

function Update_Pricing() {
  // 替换阻塞弹窗为非阻塞提示
  SpreadsheetApp.getActive().toast('开始更新定价','🔄 更新',10);  

  // 当前工作簿 
  const wb = SpreadsheetApp.getActiveSpreadsheet();                                                                              

  // 仪表板操作：直接定位目标文本
  const dash = wb.getSheetByName("Dashboard");
  const dashTarget = dash.createTextFinder("Competitor Information Upload").findNext();
  if (dashTarget) {
    dash.getRange(dashTarget.getRow(), 4).setValue("Incomplete");
    SpreadsheetApp.getActive().toast('仪表板已更新','🔄 更新',20);
  }

  // 获取外部工作簿ID：直接定位目标文本
  const settings = wb.getSheetByName("Ref_Config");
  const settingsTarget = settings.createTextFinder("Khg - Competitor Pricing Workbook").findNext();
  let srcSpreadsheetId = "";
  if (settingsTarget) {
    srcSpreadsheetId = settings.getRange(settingsTarget.getRow(), 4).getValue();
    SpreadsheetApp.getActive().toast('已获取Spreadsheet ID，正在加载数据','🔄 更新',60);
    Logger.log(srcSpreadsheetId);
  }

  // 读取外部工作簿数据
  if (srcSpreadsheetId) {
    const srcwb = SpreadsheetApp.openById(srcSpreadsheetId);
    const srcsheet = srcwb.getSheetByName("Summary");
    // 使用offset获取从第2行开始的有效数据范围
    const srcdata = srcsheet.getDataRange().offset(1, 0).getValues();
    SpreadsheetApp.getActive().toast('已获取源数据','🔄 更新',40);
  }
}

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