Google Apps Script执行异常：getRange读取未定义属性错误排查

核心错误出在循环边界的判断上：

• 代码中写了for (var i=0;i<=sheet.length;i++)，但数组索引从0开始，sheet.length是目标文档的工作表总数，当i等于sheet.length时，sheet[i]会返回undefined（最后一个工作表的索引是sheet.length-1），此时调用sheets.getRange("A1")必然抛出Cannot read properties of undefined (reading 'getRange')的错误。
• 初始运行看似正常，大概率是第一次运行时，循环还没执行到i = sheet.length就找到了匹配的工作表并完成了数据写入，但脚本最终还是会走到错误的循环步，导致中断，进而出现部分数据被回滚或未完全写入的情况。

把循环条件改成i < sheet.length，同时优化了变量命名和重复读取的问题：

function newSheet() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  const templateSheet = ss.getSheetByName("Template");
  var sheetName = templateSheet.getRange("G1").getValue();
  templateSheet.copyTo(ss).setName("F"+sheetName);
  var ods = ss.getSheetByName("F"+sheetName);
  var ds = SpreadsheetApp.openById("1meEEfjXuOKQ3jCZi2wwmvz7CH83crsPzgnhOEC0rDhI");
  var sheetList = ds.getSheets(); 
  // 把label读取移到循环外，避免每次循环都调用API
  var label = templateSheet.getRange("A1").getValue();
  
  // 修正循环边界：只遍历到最后一个工作表的索引
  for (var i=0;i<sheetList.length;i++){
    var currentSheet = sheetList[i];
    var range = currentSheet.getRange("A1").getValue();
    
    if(range==label){
      // 读取目标数据
      var values1 = currentSheet.getRange("A9:B14").getValues();
      var values2 = currentSheet.getRange("G8").getValues();
      var values3 = currentSheet.getRange("A17:A22").getValues();
      var values4 = currentSheet.getRange("A25:A32").getValues();
      var values5 = currentSheet.getRange("A34:G44").getValues();
      var values6 = currentSheet.getRange("A45:A49").getValues();
      var values7 = currentSheet.getRange("A52:A58").getValues();
      var values8 = currentSheet.getRange("A62:A67").getValues();
      var values9 = currentSheet.getRange("E69:E74").getValues();
      var values10 = currentSheet.getRange("E100:E103").getValues();
      var values11 = currentSheet.getRange("H100:H101").getValues();
      
      // 写入到新工作表
      ods.getRange("A9:B14").setValues(values1);
      ods.getRange("G8").setValues(values2);
      ods.getRange("A17:A22").setValues(values3);
      ods.getRange("A25:A32").setValues(values4);
      ods.getRange("A34:G44").setValues(values5);
      ods.getRange("A45:A49").setValues(values6);
      ods.getRange("A52:A58").setValues(values7);
      ods.getRange("A62:A67").setValues(values8);
      ods.getRange("E69:E74").setValues(values9);
      ods.getRange("E100:E103").setValues(values10);
      ods.getRange("H100:H101").setValues(values11);
      
      // 如果找到匹配的表后不需要继续遍历，加break终止循环
      break;
    }
  }
}

• 变量命名：把sheet、sheets改成sheetList、currentSheet，避免变量名混淆，提升代码可读性。
• 减少API调用：像label这种不需要在循环内重复读取的值，移到循环外，降低Google Apps Script的API调用次数，提升运行速度。
• 错误捕获：可以给代码加try-catch块，避免脚本直接中断，还能直观看到错误信息：

function newSheet() {
  try {
    // 上面的修正后代码
  } catch (e) {
    SpreadsheetApp.getUi().alert("脚本出错：" + e.message);
    console.error(e);
  }
}

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