如何在Google Apps Script的forEach循环中正确使用offset方法

核心问题 #

你当前代码的关键错误是：Avals是通过getValues()获取的二维数组，而非Spreadsheet的Range对象，所以无法调用offset()方法——这个方法只能用于Range对象，数组没有这个属性。

修正后的代码 #

下面是实现需求的正确代码，会遍历所有有效行，完成C列加D列、清空D列的操作：

function AddInventory2() {
  const ss = SpreadsheetApp.getActive();
  const sh = ss.getSheetByName("Total Inventory");
  if (!sh) return; // 防止工作表不存在报错

  // 获取包含A-D列的所有有效数据行（从第1行到最后有内容的行）
  const dataRange = sh.getDataRange();
  const values = dataRange.getValues();
  const numRows = values.length;

  // 遍历每一行，处理C、D列的值
  for (let i = 0; i < numRows; i++) {
    // C列是索引2，D列是索引3（数组从0开始计数）
    const cValue = values[i][2] || 0; // 空值默认按0处理
    const dValue = values[i][3] || 0;
    values[i][2] = cValue + dValue; // C列更新为相加后的值
    values[i][3] = ""; // 清空D列
  }

  // 将修改后的数据写回工作表
  dataRange.setValues(values);
}

代码说明 #

• 用getDataRange()直接获取所有有内容的单元格区域，比手动计算最后一行更高效准确。
• 先把所有数据读到数组中处理，最后一次性写回，比逐行操作单元格性能好很多（Google Apps Script中减少与工作表的交互次数很重要）。
• 用|| 0处理空值，避免空单元格相加出现NaN的问题。
• 添加了if (!sh)判断，防止工作表不存在时抛出错误。

替代方案（逐行操作Range） #

如果你坚持要逐行通过Range对象操作（性能略差，适合数据量小的场景），可以这样写：

function AddInventory2() {
  const ss = SpreadsheetApp.getActive();
  const sh = ss.getSheetByName("Total Inventory");
  if (!sh) return;

  const lrow = sh.getLastRow();
  const Avals = sh.getRange("A1:A" + lrow).getValues();
  const Alast = lrow - Avals.reverse().findIndex(c => c[0] !== '');

  // 遍历从第1行到Alast行
  for (let i = 1; i <= Alast; i++) {
    const cRange = sh.getRange(i, 3); // 第i行第3列（C列）
    const dRange = sh.getRange(i, 4); // 第i行第4列（D列）
    
    const cValue = cRange.getValue() || 0;
    const dValue = dRange.getValue() || 0;
    
    cRange.setValue(cValue + dValue);
    dRange.setValue("");
  }
}

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