如何编写Google Apps Script快速定位并激活下一个非空单元格？

在包含数字和空白单元格的表格指定范围A14:I22中，需用Google Apps Script按从左到右、从上到下的顺序快速定位并激活下一个非空单元格。当前通过循环逐个查找数字的方法效率低下，寻求高效实现方案。

当前低效代码 #

for(let x=1;x<=9;x++){
    if(SpreadsheetApp.getActive().getRange('A14:I22').createTextFinder(x).matchEntireCell(true).findNext()==null){continue}
    SpreadsheetApp.getActive().getRange('A14:I22').createTextFinder(x).matchEntireCell(true).findNext().activate();
}

尝试过的无效代码 #

SpreadsheetApp.getActive().getRange('A14:I22').createTextFinder(SpreadsheetApp.getActive().getRange('A14:I22').getActiveRange().getValues().length('1').findNext().activate());

SpreadsheetApp.getActive().getRange('A14:I22').createTextFinder().matchEntireCell(true).findNext(<>"").activate()

高效实现思路 #

方法1：批量读取数据后内存遍历 #

核心是减少Spreadsheet服务调用次数（GAS中服务调用是性能瓶颈），一次性读取范围所有值后在内存中按顺序遍历：

function activateNextNonEmptyCell() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const targetRange = sheet.getRange('A14:I22');
  const values = targetRange.getValues();
  const startRow = targetRange.getRow();
  const startCol = targetRange.getColumn();

  // 按从上到下、从左到右顺序遍历
  for (let rowIdx = 0; rowIdx < values.length; rowIdx++) {
    for (let colIdx = 0; colIdx < values[rowIdx].length; colIdx++) {
      const cellValue = values[rowIdx][colIdx];
      // 排除空值、null和undefined，若需保留数字0可调整判断逻辑
      if (cellValue !== "" && cellValue !== null && typeof cellValue !== 'undefined') {
        const targetCell = sheet.getRange(startRow + rowIdx, startCol + colIdx);
        targetCell.activate();
        return; // 找到第一个非空单元格后终止
      }
    }
  }
}

若需从当前激活单元格之后开始查找，可修改遍历起点，从当前单元格的行列偏移量开始遍历。

方法2：用TextFinder正则匹配非空内容 #

利用TextFinder内置的正则匹配能力，直接查找非空单元格，避免循环枚举数字：

function activateNextNonEmptyCellWithTextFinder() {
  const targetRange = SpreadsheetApp.getActive().getRange('A14:I22');
  // 正则匹配任意非空白字符，匹配非空单元格
  const finder = targetRange.createTextFinder("\\S")
    .useRegularExpression(true)
    .matchEntireCell(false);
  
  const nextCell = finder.findNext();
  if (nextCell) {
    nextCell.activate();
  }
}

如果需要从当前激活单元格的下一个位置开始查找，可传入当前单元格作为查找起点：

const currentCell = SpreadsheetApp.getActiveRange();
const nextCell = finder.findNext(currentCell);

补充：定位当前单元格之后的下一个非空 #

若需求是从当前激活单元格的后续位置开始查找，可调整遍历逻辑：

function activateNextNonEmptyAfterCurrent() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const targetRange = sheet.getRange('A14:I22');
  const values = targetRange.getValues();
  const startRow = targetRange.getRow();
  const startCol = targetRange.getColumn();
  const currentRowOffset = sheet.getActiveRange().getRow() - startRow;
  const currentColOffset = sheet.getActiveRange().getColumn() - startCol;

  // 先遍历当前行的后续列
  for (let col = currentColOffset + 1; col < values[currentRowOffset].length; col++) {
    if (values[currentRowOffset][col] !== "" && values[currentRowOffset][col] !== null) {
      sheet.getRange(startRow + currentRowOffset, startCol + col).activate();
      return;
    }
  }
  // 当前行无后续非空，遍历后续行
  for (let row = currentRowOffset + 1; row < values.length; row++) {
    for (let col = 0; col < values[row].length; col++) {
      if (values[row][col] !== "" && values[row][col] !== null) {
        sheet.getRange(startRow + row, startCol + col).activate();
        return;
      }
    }
  }
}

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