如何遍历单元格区域并保留原始行列索引而非仅遍历值？

我们有如下表格：

想要遍历第1行，编写了如下代码：

var sheet = SpreadsheetApp.getActiveSheet();

var peopleNamesRangeWithEmptyCells = sheet.getRange('A1:F1'); // ← 这里是人名，比如John、Juan等
var peopleNamesRange = [];
peopleNamesRangeWithEmptyCells.forEach(function (cell) {
   if (cell.value() != "") {
     doSomethingOnThatColumn(cell.value(), cell.getColumn());
   }
});

运行时出现错误：

TypeError: peopleNamesRangeWithEmptyCells.forEach is not a function

知道常用方法是使用getValues()：

var peopleNamesRangeWithEmptyCells = sheet.getRange('A1:F1').getValues(); // ← 这里是人名，比如John、Juan等

但这样会丢失原始的行和列信息，无法调用类似doSomethingOnThatColumn(cell.value(), cell.getColumn());的带列参数的函数。

困扰点：如何遍历单元格区域而非仅遍历其值，同时保留原始行列索引？

方法1：使用getCells()获取单个单元格对象数组 #

getRange()返回的是Range对象，本身没有forEach方法，但可以通过getCells()方法获取区域内所有单元格的对象数组，之后就能用forEach遍历，同时保留每个单元格的行列信息：

var sheet = SpreadsheetApp.getActiveSheet();
var peopleNamesRangeWithEmptyCells = sheet.getRange('A1:F1');
// 获取区域内所有单元格对象组成的数组
var cells = peopleNamesRangeWithEmptyCells.getCells();
cells.forEach(function (cell) {
  if (cell.getValue() !== "") {
    doSomethingOnThatColumn(cell.getValue(), cell.getColumn());
  }
});

方法2：通过行列索引手动遍历 #

如果不想用getCells()，可以通过区域的起始行列和尺寸来逐个获取单元格，这种方式更灵活：

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange('A1:F1');
var startRow = range.getRow();
var startCol = range.getColumn();
var numCols = range.getNumColumns();

for (var col = 0; col < numCols; col++) {
  var cell = range.getCell(1, col + 1); // 行固定为1，列从1开始计数
  var value = cell.getValue();
  if (value !== "") {
    doSomethingOnThatColumn(value, startCol + col); // 计算实际列号
  }
}

方法3：结合getValues()和行列信息推导 #

如果想兼顾getValues()的效率（批量取值更快），可以通过区域的起始列来推导每个值对应的实际列号：

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange('A1:F1');
var values = range.getValues()[0]; // 获取第一行的一维数组
var startCol = range.getColumn();

values.forEach(function (value, index) {
  if (value !== "") {
    var actualCol = startCol + index;
    doSomethingOnThatColumn(value, actualCol);
  }
});

这种方法效率更高，适合处理大区域，因为getValues()是批量操作，比逐个获取单元格更快。

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