如何优化App Script在Google Sheets间批量传递50+项数据的运行速度

核心优化思路是把多次零散的单元格读写操作合并为2次批量操作：1次批量读取「Students」表所有需要的字段值，1次批量写入整行数据到「Master」表，总API调用次数从几十次降到3次以内，运行速度可以从1分钟缩短到1秒内。

优化后完整代码 #

function submitStudentData(){
  const caseloadManager = SpreadsheetApp.getActiveSpreadsheet();
  const enterStudents = caseloadManager.getSheetByName('Students');
  const masterSheet = caseloadManager.getSheetByName('Master');
  const blankRow = masterSheet.getLastRow() + 1;

  // 配置映射关系：[Master表列号, Students表读取位置]，你可以对照原来的逻辑补全剩下的52项
  const fieldMap = [
    [1, "Z1"],   // 拼接好的学生姓名
    [2, "C8"],   // 姓氏
    [3, "C6"],   // 名字
    [4, "C10"],  // 常用称呼
    [5, "E10"],  // 学生ID
    [6, "E6"],   // 出生日期
    [7, "E8"],   // 年级
    [8, "E12"],  // 上一次年度评估日期
    [10, "E14"], // 上一次FIE日期
    [11, "Z2"],  // 计算得出的FIE到期日
    [12, "G14"], // 评估状态
    [13, "G6"],  // PD
    [14, "G8"],  // SD
    [15, "G10"], // TD
    [16, "G3"],  // 拼接好的残疾类型
    [18, "G12"], // 项目类型
    [19, "I10"], // EB
    [20, "I6"],  // DYS
    [21, "I8"],  // GT
    [22, "I14"], // BIP
    [24, "I12"], // ESY
    [29, "K6"],  // TR
    [30, "K8"],  // OT
    // 你可以按照上面的格式继续添加剩下的字段映射，顺序不影响
  ];

  // 一次性读取所有需要的Students表单元格值
  const sourceRanges = fieldMap.map(item => enterStudents.getRange(item[1]));
  const sourceValues = enterStudents.getRangeList(sourceRanges.map(r => r.getA1Notation())).getRanges().map(r => r.getValue());

  // 初始化空行数据，默认所有列值为空
  const maxCol = Math.max(...fieldMap.map(item => item[0]));
  const newRow = new Array(maxCol).fill("");

  // 把读取到的值填充到对应列位置
  fieldMap.forEach((item, index) => {
    newRow[item[0] - 1] = sourceValues[index]; // 数组下标从0开始，所以列号减1
  });

  // 一次性写入整行数据到Master表
  masterSheet.getRange(blankRow, 1, 1, newRow.length).setValues([newRow]);

  // 保留你原来的清空录入字段逻辑
  const clearFields = enterStudents.getRangeList(['C6:C18', 'C22', 'E6:E18','G6:G14','G20','I6:I14','K6:K16', 'M6:M18']);
  clearFields.clearContent();
}

改动说明 #

• 你不需要调整原来「Students」表和「Master」表的结构，只需要对照你原来的逐行赋值逻辑，把没列完的字段按照[Master列号, Students单元格位置]的格式补到fieldMap数组里即可
• 所有读写操作都合并为批量操作，避免了逐单元格调用API的耗时问题
• 保留了你原有的录入字段清空逻辑，使用习惯和之前完全一致

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