如何用Google Apps Script优化表格按A列分组3000+行并自动折叠

核心优化逻辑 #

• 减少API调用次数：原脚本逐行调用Spreadsheet服务接口是性能耗时的核心来源，优化后优先在内存中计算好分组区间，再批量调用接口完成操作
• 批量操作替代逐行遍历：移除旧分组、创建分组、折叠分组三个环节都采用批量处理逻辑，3000行数据的执行耗时可以从分钟级降到秒级

优化后完整代码 #

// 移除所有旧行分组（批量处理）
function removeAllGroups() {
  const ss = SpreadsheetApp.getActive();
  const sh = ss.getSheetByName("Pipeline");
  const lastRow = sh.getLastRow();
  // 直接按层级批量移除所有行分组，无需逐行判断
  while (sh.getRowGroupDepth(1) > 0) {
    sh.removeRowGroups(1, lastRow, sh.getRowGroupDepth(1));
  }
}

// 批量创建行分组
function groupRows() {
  const ss = SpreadsheetApp.getActive();
  const sh = ss.getSheetByName('Pipeline');
  const lastRow = sh.getLastRow();
  // 一次性读取所有A列层级数据
  const levels = sh.getRange(1, 1, lastRow).getValues().flat();
  let startRow = null;
  // 内存中遍历计算所有需要分组的连续区间
  for (let i = 0; i < levels.length; i++) {
    const currentLevel = levels[i];
    if (currentLevel === 0 && startRow !== null) {
      // 遇到下一个0层级，给前面连续的1区间创建分组
      const groupLength = i - startRow;
      if (groupLength > 0) {
        sh.shiftRowGroupDepth(startRow + 1, groupLength, 1);
      }
      startRow = null;
    } else if (currentLevel === 1 && startRow === null) {
      // 记录1区间的起始行位置
      startRow = i;
    }
  }
  // 处理表格末尾的1区间
  if (startRow !== null) {
    const groupLength = lastRow - startRow;
    if (groupLength > 0) {
      sh.shiftRowGroupDepth(startRow + 1, groupLength, 1);
    }
  }
}

// 批量折叠所有分组
function collapseAllGroups() {
  const ss = SpreadsheetApp.getActive();
  const sh = ss.getSheetByName('Pipeline');
  const maxDepth = sh.getRowGroupDepth(1);
  // 调用原生批量折叠接口，无需逐行处理
  for (let depth = 1; depth <= maxDepth; depth++) {
    sh.collapseAllRowGroups(depth);
  }
}

// 总执行入口，直接调用此函数即可完成全流程操作
function runGroupProcess() {
  removeAllGroups();
  groupRows();
  collapseAllGroups();
}

优化效果说明 #

• 移除旧分组逻辑：API调用次数从原有的几千次降到最多几次（本需求只有1层分组，仅需调用1次）
• 创建分组逻辑：先在内存中计算连续1的区间，每段连续区间仅调用1次分组接口，3000行数据如果有100个分组，仅需调用100次接口，远低于原方案的3000次
• 折叠分组逻辑：调用原生批量折叠接口，1次调用即可完成所有分组折叠操作

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