Google Sheets脚本如何通过rangeId获取对应的Range对象？

报错原因 #

你获取到的rangeId是谷歌表格内部给每个范围分配的唯一标识，不属于用户手动创建的命名范围，因此调用getRangeByName()方法无法匹配到对应对象，只会返回null。

完整实现代码 #

直接调用谷歌官方提供的getRangeById()接口即可通过rangeId获取对应Range对象，结合你的业务需求的完整代码如下：

function copyCheckedLinkValueToSheet3() {
  // 初始化表格和工作表对象
  const spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
  const sheet1 = spreadsheet.getSheetByName('Sheet1'); // 替换为你的Sheet1实际名称
  const targetSheet = spreadsheet.getSheetByName('Sheet3'); // 替换为你的Sheet3实际名称

  // 读取Sheet1所有有效行数据
  const allRows = sheet1.getDataRange().getValues();

  allRows.forEach((row, index) => {
    // 行号从1开始，数组下标从0开始，所以要+1
    const currentRowNum = index + 1;
    // 跳过未勾选复选框的行
    const checkBoxValue = row[0];
    if (!checkBoxValue) return;

    // 提取第二列的链接
    const linkCell = sheet1.getRange(currentRowNum, 2);
    const linkUrl = linkCell.getRichTextValue().getLinkUrl();
    if (!linkUrl) return;

    // 从URL中提取rangeId的纯数字部分
    const rangeId = linkUrl.match(/rangeid=(\d+)/)?.[1];
    if (!rangeId) return;

    // 直接通过rangeId获取对应Range对象
    const sourceRange = spreadsheet.getRangeById(rangeId);
    if (!sourceRange) return;

    // 读取Sheet2对应单元格的值，写入Sheet3最后一行
    const sourceValue = sourceRange.getValue();
    targetSheet.appendRow([sourceValue]);
  });
  // 执行完成提示，不需要可以删除
  SpreadsheetApp.getUi().alert('已完成选中数据的复制');
}

使用说明 #

• 将代码中工作表名称替换为你实际的表格名称
• 在Sheet1插入按钮，绑定函数copyCheckedLinkValueToSheet3即可触发执行
• 若遇到极个别旧版Runtime不支持getRangeById()的情况，可以手动修改Sheet2的链接格式为#gid=工作表ID&range=单元格位置，通过提取gid和单元格位置字符串，调用spreadsheet.getSheetById(gid).getRange(位置字符串)即可获取对应Range。

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