Google Apps Script 表格行分组函数运行慢有哪些优化方案？

性能问题核心原因 #

你当前脚本耗时过长的根本原因是循环内逐行调用Spreadsheet服务API：每一次getRowGroupDepth、remove、shiftRowGroupDepth都是独立的服务端请求，4000行累计产生数千次网络IO，自然会消耗大量时间。

具体优化建议 #

1. 优化removeAllGroups函数 #

• 倒序遍历行：行分组的子行默认在父行下方，倒序删除不会因上层分组删除导致行号错位，无需重复校验已处理行
• 跳过已删除分组的覆盖行：删除某行的N级分组后，其下属的子行分组会同步被删除，直接跳过多余的行校验
• 操作前关闭自动计算，避免表格中途重算

2. 优化groupRows函数 #

• 内存中先聚合连续同深度的行：将A列的层级值按连续相同值合并为批量操作区间，单次API调用处理一批行，将数千次请求压缩到数十次

3. 高阶优化：使用Sheets高级服务批量操作 #

开启Sheets高级服务后调用batchUpdate接口，所有分组的删除、新增操作一次性提交到服务端处理，性能比原生SpreadsheetApp方法提升10倍以上

优化后代码示例 #

无需高级服务的版本 #

// 预处理开关：关闭自动计算、暂停历史记录，操作后恢复
function withPerformanceOptimization(sheet, callback) {
  const ss = sheet.getParent();
  const originalAutoCalc = ss.isAutoCalculationEnabled();
  ss.setAutoCalculationEnabled(false);
  ss.suspendCollectionOfHistoricVersions();
  try {
    callback();
  } finally {
    ss.setAutoCalculationEnabled(originalAutoCalc);
    ss.resumeCollectionOfHistoricVersions();
    SpreadsheetApp.flush();
  }
}

function removeAllGroups() {
  const sheet = SpreadsheetApp.getActive().getSheetByName("sheet1");
  const lastRow = sheet.getDataRange().getLastRow();
  withPerformanceOptimization(sheet, () => {
    // 倒序遍历
    let row = lastRow;
    while (row >= 1) {
      const depth = sheet.getRowGroupDepth(row);
      if (depth < 1) {
        row--;
        continue;
      }
      sheet.getRowGroup(row, depth).remove();
      // 跳过该分组覆盖的子行，无需重复校验
      row -= depth;
    }
  })
}

function groupRows() {
  const sheet = SpreadsheetApp.getActive().getSheetByName("sheet1");
  const lastRow = sheet.getLastRow();
  const levels = sheet.getRange("A2:A" + lastRow).getValues().flat();
  withPerformanceOptimization(sheet, () => {
    // 聚合连续同深度的行区间
    let startRow = 2;
    let currentLevel = levels[0];
    for (let i = 1; i < levels.length; i++) {
      if (levels[i] !== currentLevel) {
        // 批量处理上一个连续区间
        sheet.getRange(startRow, 1, i - startRow + 1, 1).shiftRowGroupDepth(currentLevel);
        startRow = i + 2;
        currentLevel = levels[i];
      }
    }
    // 处理最后一个区间
    sheet.getRange(startRow, 1, lastRow - startRow + 1, 1).shiftRowGroupDepth(currentLevel);
  })
}

使用Sheets高级服务的极速版本 #

需要先在Apps Script编辑器开启Sheets API服务：左侧菜单「扩展」→「服务」→找到「Google Sheets API」添加即可。

function batchUpdateGroups() {
  const ss = SpreadsheetApp.getActive();
  const sheet = ss.getSheetByName("sheet1");
  const sheetId = sheet.getSheetId();
  const lastRow = sheet.getLastRow();
  const levels = sheet.getRange("A2:A" + lastRow).getValues().flat();

  const requests = [];
  // 先添加删除所有分组的请求
  requests.push({
    ungroupDimension: {
      range: {
        sheetId: sheetId,
        startIndex: 0,
        endIndex: lastRow,
        dimension: "ROWS"
      }
    }
  });
  // 批量添加分组请求
  levels.forEach((level, i) => {
    if (level < 1) return;
    for (let d = 0; d < level; d++) {
      requests.push({
        addDimensionGroup: {
          range: {
            sheetId: sheetId,
            startIndex: i + 1,
            endIndex: i + 2,
            dimension: "ROWS"
          }
        }
      });
    }
  });
  // 一次性提交所有请求
  Sheets.Spreadsheets.batchUpdate({requests: requests}, ss.getId());
}

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