Google Sheets Apps Script 发票数据迁移代码性能优化求助

原代码处理大量（比如100行）发票数据时速度骤降，核心原因是频繁调用getRange()和setValue()这类与电子表格直接交互的方法——每一次调用都需要额外的通信开销，数据量越大，效率越低。以下是针对性的优化方案：

优化思路 #

• 一次性读取所有需要的数据源到内存数组，避免多次单独读取单元格
• 构建好要写入的完整数据数组后，一次性写入目标工作表
• 批量清除原表内容，减少操作次数
• 动态遍历所有非空行，不用硬编码行号，适配任意数量的待迁移数据

优化后的代码 #

function Entry() {
  const SS = SpreadsheetApp.getActiveSpreadsheet();
  const entrySheet = SS.getSheetByName("entry");
  const dataSheet = SS.getSheetByName("data");

  // 1. 一次性读取需要的所有数据到内存
  // 读取表头固定值（D3、F3）
  const headerValues = entrySheet.getRange("D3:F3").getValues()[0];
  const fixedCol1 = headerValues[0]; // D3的值
  const fixedCol2 = headerValues[2]; // F3的值

  // 读取发票明细行（D5:G23，取D、E、G列）
  const range = entrySheet.getRange("D5:G23");
  const rawData = range.getValues();
  const rowsToWrite = [];

  // 2. 筛选非空行，构建要写入的数据数组
  rawData.forEach(row => {
    const dCol = row[0]; // D列的值
    if (dCol !== "") {
      // 每一行的结构：[fixedCol1, fixedCol2, D列, E列, G列]
      rowsToWrite.push([fixedCol1, fixedCol2, dCol, row[1], row[3]]);
    }
  });

  // 3. 批量写入到data表
  if (rowsToWrite.length > 0) {
    const startRow = dataSheet.getLastRow() + 1;
    dataSheet.getRange(startRow, 1, rowsToWrite.length, 5).setValues(rowsToWrite);
  }

  // 4. 批量清除entry表内容
  entrySheet.getRange("D3").clearContent();
  entrySheet.getRange("H3:J3").clearContent();
  entrySheet.getRange("D5:D23").clearContent();
  entrySheet.getRange("E5:E23").clearContent();
  entrySheet.getRange("G5:G23").clearContent();
}

关键优化点说明 #

• 批量读写：用getValues()一次性读取整段数据，setValues()一次性写入所有行，把原来几十上百次的交互压缩成2次，大幅提升速度
• 内存处理：所有数据筛选、拼接都在内存数组中完成，避免频繁操作电子表格
• 动态适配：通过forEach遍历所有明细行，自动处理非空数据，不管是10行还是100行都能适配，不用修改代码
• 减少冗余读取：固定值（D3、F3）只读取一次，避免重复获取

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