如何优化Google Sheets的installedOnEdit脚本以快速批量处理行保护？

核心问题分析 #

你当前的代码主要有两个瓶颈：

1. 每次触发都要遍历所有范围保护查找对应行的保护，这个操作在保护数量较多时会非常耗时；
2. 仅处理单个单元格，连续勾选多个复选框时，脚本来不及处理完前一个请求，后续触发的事件就会被跳过。

优化后的代码 #

function installedOnEdit(e) {
  const sheetName = "請求管理";
  const checkboxCol = 21;
  const targetCols = 21; // 要保护的列数

  const range = e.range;
  const sheet = range.getSheet();
  
  // 过滤非目标工作表和非复选框列的操作
  if (sheet.getSheetName() !== sheetName || range.columnStart !== checkboxCol) return;
  
  // 处理批量操作：收集所有被编辑的复选框行状态
  const editedRows = [];
  for (let row = range.rowStart; row <= range.rowEnd; row++) {
    const cell = sheet.getRange(row, checkboxCol);
    editedRows.push({
      row: row,
      isChecked: cell.isChecked()
    });
  }

  // 一次性获取所有范围保护，构建行号到保护对象的映射，避免重复遍历
  const protectionsMap = new Map();
  const allProtections = sheet.getProtections(SpreadsheetApp.ProtectionType.RANGE);
  allProtections.forEach(protection => {
    const protectRange = protection.getRange();
    // 只筛选我们创建的、覆盖前21列的行保护
    if (protectRange.getColumn() === 1 && protectRange.getNumColumns() === targetCols) {
      protectionsMap.set(protectRange.getRow(), protection);
    }
  });

  // 批量处理每一行的保护逻辑
  editedRows.forEach(item => {
    const row = item.row;
    const existingProtection = protectionsMap.get(row);

    if (item.isChecked && !existingProtection) {
      // 勾选状态且无保护：创建行保护
      const protectRange = sheet.getRange(row, 1, 1, targetCols);
      protectRange.protect()
        .setWarningOnly(true)
        .setDescription(`行${row}保护`);
    } else if (!item.isChecked && existingProtection) {
      // 取消勾选且有保护：移除行保护
      existingProtection.remove();
    }
  });
}

关键优化点 #

• 批量处理编辑事件：支持一次勾选/取消多个复选框的场景，一次性处理所有被编辑的行，减少重复触发的开销；
• 预构建保护映射：一次性获取所有保护并存储为行号->保护对象的Map，避免每次处理单行都遍历全部保护，大幅降低API调用次数；
• 精准过滤保护：只处理我们创建的、覆盖前21列的行保护，排除其他无关保护的干扰；
• 修复未定义变量：把原代码中未定义的rownum改为明确的行${row}保护，避免运行报错。

额外提速建议 #

1. 若工作表中保护数量极大，可以用PropertiesService存储行号和保护ID的映射，不用每次都调用getProtections，进一步减少API开销；
2. 确保脚本启用V8运行时（默认已启用），V8引擎的执行效率远高于旧引擎；
3. 避免在循环内单独调用getRange类API，尽量批量操作数据（上述代码已优化此点）。

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