优化Google Sheets脚本：高效从其他单元格生成单元格批注

我为和朋友玩的TTRPG制作了一份Google表格，尝试实现自动化单元格批注功能。已找到可行方案并修改适配我的表格，但作为Google Scripts新手，认为当前实现效率低下。现有脚本如下：

function onEdit(e){  
   var ss = SpreadsheetApp.getActiveSpreadsheet();  
   var sheet = ss.getSheetByName('Copy of Digital');   
   var range = sheet.getRange("R31:T59");
   range.clearNote();

  for (var x=1;x<30;x++) {   
    range.getCell(x, 1).setNote(range.getCell(x, 3).getValue());  
  } 
}

该脚本可满足基本需求，但希望进一步优化，以下是针对提出的问题的解决方案，附带整合所有优化点的最终脚本：

问题1：跳过空行、指定精确单元格、绝对引用支持 #

• 跳过空行：直接指定要处理的行号数组，或者在循环里判断来源单元格是否为空，为空则跳过/清除批注。
• 指定精确单元格：完全可以，用sheet.getRange(行号, 列号)或者sheet.getRange("单元格地址")就能精准定位，比如sheet.getRange("R31")。
• 绝对引用：Google Script里直接写死行号列号就是绝对引用效果，比如sheet.getRange(31, 20)对应T31，不会像表格公式那样自动偏移，完全符合你的需求。

问题2：支持多个作用范围 #

可以把多个范围的配置存进数组，循环遍历处理，避免重复写逻辑。比如你可以定义多个{targetCol: 目标列, sourceCol: 来源列, rows: [行号数组]}的配置项，脚本会逐个处理。

问题3：限制onEdit仅在特定范围触发 #

利用onEdit的事件对象e，获取编辑的单元格位置，判断它是否在你指定的触发范围内（比如批注来源列的指定行），如果不在就直接退出函数，避免无效执行。

问题4：支持多玩家使用各自标签页 #

不用硬写死工作表名称，直接用e.source.getActiveSheet()获取当前被编辑的工作表，只要每个标签页的结构一致，玩家在自己的标签页操作时，脚本会自动针对当前工作表处理。

整合所有优化点的最终脚本 #

function onEdit(e) {
  // 获取当前编辑的工作表和单元格范围
  const editedSheet = e.source.getActiveSheet();
  const editedRange = e.range;

  // 定义要处理的多个范围配置，按需添加或修改
  const processRanges = [
    // 第一个范围：R列（18列）加批注，来源是T列（20列），处理指定的非空行
    { targetCol: 18, sourceCol: 20, rows: [31,33,35,37,39,41,43,45,47,49,51,53,55,57,59] },
    // 可以添加第二个范围，比如U列（21列）加批注，来源是W列（23列），处理指定行
    // { targetCol: 21, sourceCol: 23, rows: [10,12,14,16] }
  ];

  // 遍历每个范围配置
  for (const config of processRanges) {
    const { targetCol, sourceCol, rows } = config;
    // 判断当前编辑的单元格是否属于这个范围的来源列和指定行
    const isTrigger = editedRange.getColumn() === sourceCol && rows.includes(editedRange.getRow());
    if (!isTrigger) continue; // 不是目标编辑，跳过当前范围处理

    // 处理当前范围的所有指定行
    for (const row of rows) {
      const sourceCell = editedSheet.getRange(row, sourceCol);
      const sourceValue = sourceCell.getValue();
      const targetCell = editedSheet.getRange(row, targetCol);

      // 来源为空时清除批注，否则设置批注
      if (sourceValue === "") {
        targetCell.clearNote();
      } else {
        targetCell.setNote(sourceValue);
      }
    }
  }
}

脚本说明 #

1. 仅当编辑的单元格是批注来源列的指定行时，才会触发处理逻辑，大幅减少无效执行
2. 通过配置数组支持多个独立范围，扩展性强
3. 直接指定要处理的行号，自动跳过空行，无需循环所有行
4. 自动适配当前编辑的工作表，支持多玩家使用各自的标签页
5. 操作更精准，避免批量清除所有批注后再重新设置，效率更高

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