Google Sheets行迁移脚本出现超时问题求助

原脚本出现超时的核心原因是循环中频繁调用SpreadsheetApp的API方法，每一次API调用都需要和Google服务器通信，当Inbox条目增多时，累计的通信耗时就会触发超时限制。

原脚本的低效点 #

• 逐行复制数据到Completed表，每行发起一次copyTo请求
• 逐行删除Inbox中的行，每行发起一次deleteRow请求
• 循环中每次插入一行空白行，多次调用insertRowsAfter

优化后的脚本 #

function doneCopy() {
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  const inboxSheet = ss.getSheetByName("Inbox");
  const completedSheet = ss.getSheetByName("Completed");
  
  // 一次性获取Inbox所有数据（J列是第10列，索引为9）
  const inboxData = inboxSheet.getDataRange().getValues();
  const lastCol = inboxSheet.getLastColumn();
  
  // 分离需保留和需移动的行
  const [rowsToKeep, rowsToMove] = inboxData.reduce(([keep, move], row) => {
    row[9] === "Y" ? move.push(row) : keep.push(row);
    return [keep, move];
  }, [[], []]);
  
  // 批量写入需移动的行到Completed表
  if (rowsToMove.length > 0) {
    const targetStartRow = completedSheet.getLastRow() + 1;
    completedSheet.getRange(targetStartRow, 1, rowsToMove.length, lastCol).setValues(rowsToMove);
  }
  
  // 清空Inbox并写入保留的行
  inboxSheet.clearContents();
  if (rowsToKeep.length > 0) {
    inboxSheet.getRange(1, 1, rowsToKeep.length, lastCol).setValues(rowsToKeep);
  }
  
  // 批量插入对应数量的空白行
  const rowsToAdd = rowsToMove.length;
  if (rowsToAdd > 0) {
    inboxSheet.insertRowsAfter(inboxSheet.getMaxRows(), rowsToAdd);
  }
}

优化说明 #

1. 批量读写数据：一次性获取Inbox全部数据，分离后批量写入目标表，将API调用次数从N次（N为需移动行数）压缩到固定几次
2. 避免逐行操作：不再循环执行复制、删除、插入操作，改为一次性处理所有需移动的行
3. 高效清空重写：用clearContents清空Inbox后写入保留行，比逐行删除效率更高；如果需要保留格式，可替换为deleteRows(1, inboxSheet.getLastRow())后再写入
4. 批量插入空白行：根据移动行数一次性插入对应数量的空白行，减少API调用

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