Google Sheets脚本优化：如何仅处理未被筛选隐藏的单元格？

你的核心问题是逐行遍历4000行数据并单独修改单元格，这种方式会产生大量Google Sheets服务请求，效率极低。以下是几种更高效的实现方案，无需遍历全部行或大幅减少服务交互次数：

方案一：使用RangeList批量处理可见行 #

先收集所有未被筛选隐藏的行对应的单元格范围，再一次性批量设置值，仅需1次服务写入请求：

const lastRow = SHEET.getLastRow();
const visibleRowNotations = [];

// 收集可见行的单元格A1标记（跳过表头行）
for (let row = 2; row <= lastRow; row++) {
  if (!SHEET.isRowHiddenByFilter(row)) {
    visibleRowNotations.push(`${SHEET.getRange(row, locationColumnArg).getA1Notation()}`);
  }
}

// 批量设置值
if (visibleRowNotations.length > 0) {
  SHEET.getRangeList(visibleRowNotations).setValue('PNDXD');
}

方案二：批量读写数据（性能最优） #

一次性读取整列数据，在内存中修改可见行对应的值，再一次性写回，仅需2次服务请求（读+写）：

const lastRow = SHEET.getLastRow();
// 读取目标列所有数据（从第2行开始，跳过表头）
const columnValues = SHEET.getRange(2, locationColumnArg, lastRow - 1, 1).getValues();

// 在内存中修改可见行的值
for (let i = 0; i < columnValues.length; i++) {
  const sheetRowNum = i + 2; // 对应工作表的实际行号
  if (!SHEET.isRowHiddenByFilter(sheetRowNum)) {
    columnValues[i][0] = 'PNDXD';
  }
}

// 一次性写回修改后的数据
SHEET.getRange(2, locationColumnArg, lastRow - 1, 1).setValues(columnValues);

方案三：直接查找匹配单元格（无需提前设置筛选） #

如果你的需求只是将所有PNDCROSS值替换为PNDXD，可以直接使用Google Sheets的TextFinder工具，它会自动定位所有匹配单元格，无需手动设置筛选：

// 创建精确匹配的文本查找器
const textFinder = SHEET.createTextFinder('PNDCROSS')
  .matchEntireCell(true) // 匹配整个单元格内容
  .matchCase(true) // 区分大小写
  .ignoreDiacritics(false);

// 获取所有匹配的单元格范围
const matchedRanges = textFinder.findAll();

// 批量替换值
if (matchedRanges.length > 0) {
  SHEET.getRangeList(matchedRanges.map(range => range.getA1Notation())).setValue('PNDXD');
}

为什么这些方案更高效？ #

原代码每一行都调用getRange()和setValue()，每个调用都是一次独立的Google Sheets服务请求，4000行就会产生4000次请求，性能极差。而优化后的方案最多仅需2次服务请求，大幅减少了网络交互开销，同时利用内存操作或平台原生工具提升处理速度。

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