如何使用App Script查找指定单元格范围内的下一个空行

以下两种实现均可满足需求：从DATA表第2行开始，忽略A、E列内容，查找B、C、D三列均为空的第一行，你给出的示例场景下运行将返回行号4。 #

方法1：逐行检查（小数据量场景首选，写法简单） #

function getFirstEmptyRow() {
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('DATA');
  // 从第2行开始遍历
  let rowNum = 2;
  while(true) {
    // 一次性获取当前行B、C、D三列的值
    const [bVal, cVal, dVal] = sheet.getRange(rowNum, 2, 1, 3).getValues()[0];
    // 判断三列是否均为空
    if(!bVal && !cVal && !dVal) {
      return rowNum;
    }
    rowNum++;
  }
}

• 优点：逻辑简单易懂，不需要额外计算范围
• 缺点：逐行调用表格API，数据超过1000行时效率较低

方法2：批量读取（大数据量场景首选，效率更高） #

一次性读取所有B2:D范围的内容到内存中判断，仅调用1次表格API，性能远高于逐行读取。

function getFirstEmptyRowFast() {
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('DATA');
  // 获取整张表的最大有效行号
  const lastRow = sheet.getLastRow();
  // 若表中只有表头，直接返回第2行
  if(lastRow < 2) return 2;
  const rangeVals = sheet.getRange(2, 2, lastRow - 1, 3).getValues();
  // 遍历数组找第一个全空的行
  for(let i = 0; i < rangeVals.length; i++) {
    const [b, c, d] = rangeVals[i];
    if(!b && !c && !d) {
      // 数组索引从0开始，对应实际行号是索引+2
      return i + 2;
    }
  }
  // 如果现有行都有数据，返回下一个新行
  return lastRow + 1;
}

写入数据示例 #

配合按钮触发的写入逻辑参考：

function writeToEmptyRow() {
  const targetSheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('DATA');
  // 替换为你从用户输入区域获取的三个值，对应RM1、RM2、RM3
  const inputVals = [用户输入RM1值, 用户输入RM2值, 用户输入RM3值];
  // 获取空行行号
  const emptyRow = getFirstEmptyRowFast();
  // 写入B、C、D列
  targetSheet.getRange(emptyRow, 2, 1, 3).setValues([inputVals]);
}

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