如何加速Google Apps Script？批量读写优化求助

核心问题 #

你的脚本慢的根源是多次调用getRange().setValue()——每一行这种代码都会发起一次和Google Sheets服务器的通信，100次就有100次往返，这是拖慢速度的关键。批量写入只需要1次通信，能大幅提升速度。

解决思路 #

1. 先把「要填充的单元格地址」和「对应数据源的列索引」做成映射表，解决单元格和源列顺序不对应的问题。
2. 一次性读取目标表单的整个数据范围到数组（数组里的每个位置对应表单的单元格）。
3. 把数据源的值通过映射表填入数组的对应位置。
4. 一次性把修改后的数组写回表单。

修改后的完整代码 #

//function to display artist info on a search form
function searchRecord() {
  var myGooglSheet = SpreadsheetApp.getActiveSpreadsheet();
  var infosheet = myGooglSheet.getSheetByName("Artist Info");
  var datasheet = myGooglSheet.getSheetByName("Database");
  
  // 获取搜索关键词
  var str = infosheet.getRange("Y4").getValue();
  // 一次性读取整个数据库的所有数据
  var values = datasheet.getDataRange().getValues();
  var valuesFound = false;

  // --------------------------
  // 第一步：创建单元格-数据源索引映射表
  // 格式："单元格地址": 数据源列索引（对应rowValue[N]里的N）
  // 把你原来的100+行setValue都转成这种键值对就行
  var cellMapping = {
    "D6": 0,    // ARTIST NAME
    "D7": 1,    // CONTACT NAME
    "F10": 5,   // CELL PHONE
    "F11": 6,   // EMAIL
    "F12": 7,   // MSGR LINK
    "I10": 18,  // CITY
    "I11": 19,  // COUNTY
    "I12": 20   // STATE
    // 在这里继续添加剩下的100个映射关系
  };
  // --------------------------

  // 遍历数据库找匹配的记录
  for (var i = 0; i < values.length; i++) {
    var rowValue = values[i];
    if (rowValue[0] == str) {
      valuesFound = true; // 标记找到记录，修复原脚本的bug
      
      // --------------------------
      // 第二步：一次性读取目标表单的整个数据范围到数组
      // 这里用getDataRange()获取已用区域，如果你知道固定范围可以改成getRange("A1:Z100")
      var infoSheetData = infosheet.getDataRange().getValues();
      // 获取表单的列数，用于计算列索引
      var columnCount = infosheet.getDataRange().getLastColumn();
      // --------------------------

      // --------------------------
      // 第三步：遍历映射表，把数据填入数组对应位置
      for (var cellAddr in cellMapping) {
        // 把单元格地址转换成数组的行、列索引（数组索引从0开始）
        // 比如D6：列D是第3列（A=0），行6是第5行（行1=0）
        var colLetter = cellAddr.match(/[A-Z]+/)[0];
        var rowNum = parseInt(cellAddr.match(/\d+/)[0]) - 1;
        var colNum = colLetter.charCodeAt(0) - 65; // A=65，所以A→0，B→1...

        // 确保数组的行和列足够，避免越界
        while (infoSheetData.length <= rowNum) {
          infoSheetData.push(new Array(columnCount).fill(""));
        }
        while (infoSheetData[rowNum].length <= colNum) {
          infoSheetData[rowNum].push("");
        }

        // 把数据源的值填入数组对应位置
        infoSheetData[rowNum][colNum] = rowValue[cellMapping[cellAddr]];
      }
      // --------------------------

      // --------------------------
      // 第四步：一次性把数组写回表单（只需要1次服务器调用）
      infosheet.getRange(1, 1, infoSheetData.length, infoSheetData[0].length).setValues(infoSheetData);
      // --------------------------

      return; // 找到记录后退出函数
    }
  }

  // 没找到记录才弹提示
  if (!valuesFound) {
    var ui = SpreadsheetApp.getUi();
    ui.alert("No record found!");
  }
}

关键说明 #

1. 映射表的扩展：你只需要把原来的每一行setValue代码，转换成"单元格地址": 数据源列索引的格式，添加到cellMapping对象里就行，不管单元格和源列顺序怎么乱都能对应。
2. 修复原脚本bug：原脚本里valuesFound永远是false，因为找到记录后直接return了，没给valuesFound赋值，现在已经修正。
3. 数组越界处理：代码里添加了数组行和列的补全逻辑，避免因为目标表单的行/列不够导致报错。

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