如何在Google Sheets脚本中遍历单元格区域并逐个处理

嘿，这个问题我之前也碰到过！其实你不需要纠结“索引提取子集”或者值数组，Google Apps Script里的Range对象有个非常实用的方法能直接帮你从大区域里拿到单个单元格的Range对象——就是getCell(rowOffset, columnOffset)，完全符合你的需求。

下面给你两种具体的实现方式，都能完美解决你的问题：

方法1：基于目标区域的相对位置遍历 #

这种方法最灵活，哪怕你后续调整了目标区域（比如改成D5:D15），代码也不用改行号，直接复用即可：

function processCellRange() {
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
  // 定义你要遍历的目标区域
  const targetRange = sheet.getRange("D2:D10");
  const totalRows = targetRange.getNumRows(); // 获取区域的总行数

  // 逐个遍历区域内的每个单元格
  for (let i = 1; i <= totalRows; i++) {
    // getCell的参数是相对于目标区域的偏移：i是区域内的第i行，1是区域内的第1列（因为你的区域是单列）
    const singleCell = targetRange.getCell(i, 1);
    // 把单个单元格传递给你的处理函数
    modifyNeighborBackgroundColor(singleCell);
  }
}

// 你提到的修改邻近单元格背景色的函数
function modifyNeighborBackgroundColor(cell) {
  // 示例：修改当前单元格右侧（偏移0行，1列）的单元格背景色
  const neighborCell = cell.offset(0, 1);
  neighborCell.setBackground("#ffeb3b"); // 设置为黄色，你可以换成任意颜色代码
}

方法2：基于绝对行号遍历 #

如果你明确知道目标区域的起始和结束行号，也可以直接循环行号来获取单个单元格，代码更直观：

function processCellRangeByRow() {
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
  const startRow = 2;
  const endRow = 10;
  const targetColumn = 4; // D列的列号是4

  for (let row = startRow; row <= endRow; row++) {
    const singleCell = sheet.getRange(row, targetColumn);
    modifyNeighborBackgroundColor(singleCell);
  }
}

关键说明 #

你之前遗漏的核心点就是getCell()方法——它允许你从一个已定义的大区域中，通过相对偏移量直接提取单个单元格的Range对象，完全不需要处理单元格的值数组。这样传递给你的函数时，正好符合“仅接受单个单元格区域”的要求，后续用offset()操作邻近单元格也完全没问题。

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