Google Apps Script遍历行数组时获取单元格值的问题

嘿，我来帮你搞定这个卡了你好几周的问题！你的核心困惑其实是没搞明白getValues()返回的数据类型——它返回的是一个二维数组，每个row参数就是这个二维数组里的一个子数组，直接通过数组索引就能拿到对应列的值，完全不需要再调用getValue()或者getRange()这类Range对象的方法~

先给你看修正后的完整代码 #

// A looping function that goes down the rows, starting with row 2, and adds +1 to +5 depending on the priority of the meal.
// Stops and continues the main script once a priority is null. 
function iterateThroughRows() {
  var activePage = SpreadsheetApp.getActive().getSheetByName("Meal List");
  var data = activePage.getDataRange().getValues();

  // 跳过表头（第一行），从第二行开始遍历
  for (var i = 1; i < data.length; i++) { 
    var row = data[i];
    // 列索引从0开始：B列（第2列）→ index1，C列→index2，D列→index3
    var mealPriority = row[1]; // MEAL ( B / 2 )
    var mealSkip = row[2]; // TEMP_SKIP ( C / 3 )
    var mealPickedChance = row[3]; // PICKED_CHANCE ( D / 4 )

    console.log("Logger Row"); // DEBUGGING LOGS
    console.log("mealPriority = " + mealPriority); // DEBUGGING LOGS
    console.log("mealSkip = " + mealSkip); // DEBUGGING LOGS
    console.log("mealPickedChance = " + mealPickedChance); // DEBUGGING LOGS

    // 当priority为null/空时停止循环
    if (mealPriority === null || mealPriority === "") {
      break;
    }

    // 处理逻辑：如果mealSkip为true，设置为false；否则累加优先级到PICKED_CHANCE
    if (mealSkip === true) {
      data[i][2] = false;
    } else {
      data[i][3] = mealPickedChance + mealPriority;
    }
  }

  // 把修改后的整个数据数组写回表格
  activePage.getDataRange().setValues(data);
}

关键知识点解释 #

1. getValues()的返回值本质：
   它返回的是一个二维数组，格式是[[表头1, 表头2, 表头3...], [行2列1值, 行2列2值...], [行3列1值...]]，所以每个row就是一行的所有值组成的数组，直接用row[列索引]就能拿到对应列的值，不需要再调用getValue()。

2. 列索引的对应关系：
   表格里的列是从A(1)开始计数，而数组索引从0开始，所以对应关系是：

   • B列（第2列）→ row[1]
   • C列（第3列）→ row[2]
   • D列（第4列）→ row[3]

3. 修改值后必须写回表格：
   直接修改数组里的row值不会自动同步到表格，必须最后调用setValues(data)把整个二维数组写回原数据范围，才能让表格里的内容更新。

4. 循环停止的优化：
   我把forEach换成了普通for循环，这样遇到mealPriority为null时，可以直接用break停止循环，更符合你“停止并继续主脚本”的需求——forEach是无法直接中断循环的。

你之前尝试的方法为什么没用？ #

getRange()、getRow()、getColumn()这些都是Range对象的专属方法，而getValues()返回的是普通的JavaScript数组，不是Range对象，所以调用这些方法会直接报错。你需要明确区分「表格单元格区域（Range）」和「区域里的数值数组」的区别：Range是表格里的单元格实体，getValues()是把这些单元格的数值提取成数组，方便批量操作。

这样调整后，你的代码应该就能正常运行了，你可以复制过去测试，有细节问题再微调就行~

备注：内容来源于stack exchange，提问作者Kim