运行Google Apps Script时报范围坐标超出工作表尺寸错误

运行抛出The coordinates of the range are outside of the dimensions of the sheet错误，本质是代码中调用的范围坐标超出了对应工作表的实际行列边界，同时代码还存在几处逻辑、拼写问题，共同导致运行失败，具体问题点如下：

• 范围获取未绑定指定工作表：代码开头直接在Spreadsheet对象上调用getRange('A2509:CU26611')，该写法默认读取当前激活工作表的范围，执行到这行时还未切换到目标工作表All Performance Data 2021 (Skai)，如果当前激活表的总行数不足26611，会直接触发越界报错。
• 方法名拼写错误：最后一行复制逻辑中，目标范围调用的是getrange，Google Apps Script对大小写敏感，正确方法名为getRange，小写写法会直接触发方法不存在的错误。
• 冗余的激活表操作：代码中多次调用setActiveSheet切换激活工作表属于前台交互逻辑，配置为定时触发时脚本无前台运行环境，这类逻辑容易因为激活状态异常导致范围获取错误。
• 未做边界校验：要粘贴的目标范围结束行是26611行，如果All Performance Data 2021 (Skai)表现有最大行数小于26611，直接向不存在的行号写入内容就会触发坐标越界报错。

function Skai1() {
  const spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
  // 直接绑定源表、目标表对象，不依赖激活状态
  const sourceSheet = spreadsheet.getSheetByName('All Performance Data 2022 (Skai)');
  const targetSheet = spreadsheet.getSheetByName('All Performance Data 2021 (Skai)');
  // 定义源数据范围、目标粘贴起始单元格
  const sourceRange = sourceSheet.getRange('A2:CU5612');
  const pasteStartRow = 2509;
  const pasteStartCol = 1;
  const sourceRowCount = sourceRange.getNumRows();
  const sourceColCount = sourceRange.getNumColumns();

  // 清空目标区域原有内容
  const clearRowCount = Math.max(targetSheet.getLastRow() - pasteStartRow + 1, 1);
  targetSheet.getRange(pasteStartRow, pasteStartCol, clearRowCount, sourceColCount)
    .clear({contentsOnly: true, skipFilteredRows: true});

  // 校验目标表行列数，不足则自动插入，避免越界
  const targetNeedEndRow = pasteStartRow + sourceRowCount - 1;
  const targetNeedEndCol = pasteStartCol + sourceColCount - 1;
  if (targetSheet.getMaxRows() < targetNeedEndRow) {
    targetSheet.insertRowsAfter(targetSheet.getMaxRows(), targetNeedEndRow - targetSheet.getMaxRows());
  }
  if (targetSheet.getMaxColumns() < targetNeedEndCol) {
    targetSheet.insertColumnsAfter(targetSheet.getMaxColumns(), targetNeedEndCol - targetSheet.getMaxColumns());
  }

  // 执行复制粘贴
  const targetPasteRange = targetSheet.getRange(pasteStartRow, pasteStartCol, sourceRowCount, sourceColCount);
  sourceRange.copyTo(targetPasteRange, SpreadsheetApp.CopyPasteType.PASTE_NORMAL, false);
}

• 修正后的代码完全移除了依赖前台激活状态的逻辑，所有范围都直接绑定对应工作表对象获取，定时触发时不会因为无前台环境报错。
• 脚本增加了行列数自动校验逻辑，粘贴前会自动判断目标表的最大行列数是否满足粘贴需求，不足时自动插入对应数量的行列，从根源避免范围越界问题。
• 清空内容时仅清空目标粘贴区域的原有内容，不会一开始就调用超出当前表维度的大范围触发报错。

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