Google Sheets脚本需求：勾选复选框插入指定格式新行

问题根源 #

你遇到的getRange not defined错误，是因为在addValues函数里直接调用了getRange()——这个方法必须通过具体的sheet对象（也就是你传入的sheet参数）来调用，它不是全局可用的函数。另外你的脚本还有拼写错误、触发逻辑不严谨、插入行位置不符合需求等问题，下面是完整修复方案：

具体修复点 #

• 所有getRange()调用前必须加上sheet.前缀，比如sheet.getRange(selectedRow,1)
• 修正拼写错误：把Suupervisor改成Supervisor（多了一个u）
• 优化onEdit触发条件：只在编辑的是复选框单元格、且被勾选时才执行逻辑，避免其他单元格编辑误触发
• 把appendRow改成insertRowsAfter：原代码是把新行加到表格最后，而需求是在选中行下方插入，这个方法更符合要求
• 修复大小写错误：Sheet.getLastRow()改成sheet.getLastRow()（sheet是变量名，小写s）
• 移除无用的while循环：用while加break完全多余，换成if判断逻辑更清晰

修复后的完整代码 #

function onEdit(e) {
  var sheet = e.source.getActiveSheet();
  var activeRange = e.range;
  var checkboxValue = activeRange.getValue();
  var selectedRow = activeRange.getRow();
  
  // 仅当编辑的是复选框且被勾选时执行
  if (checkboxValue === true && activeRange.getDataValidation() && activeRange.getDataValidation().getCriteriaType() === SpreadsheetApp.DataValidationCriteria.CHECKBOX) {
    var selectedStaff = sheet.getRange(selectedRow, 2).getValue();
    addValues(selectedRow, sheet, selectedStaff);
  }
}

function addValues(selectedRow, sheet, selectedStaff) {
  // 原行Staff列是目标值时不插入
  if (selectedStaff !== "Staff ABC, Supervisor") {
    // 在选中行下方插入新行
    sheet.insertRowsAfter(selectedRow, 1);
    var newRow = selectedRow + 1;
    
    // 复制原行的日期（带格式）
    var originalDate = sheet.getRange(selectedRow, 1).getValue();
    sheet.getRange(newRow, 1).setValue(originalDate).setNumberFormat("dd/MM/yy");
    
    // 设置Staff列固定值
    sheet.getRange(newRow, 2).setValue("Staff ABC, Supervisor");
    
    // 复制原行第7列的值
    var originalCol7Value = sheet.getRange(selectedRow, 7).getValue();
    sheet.getRange(newRow, 7).setValue(originalCol7Value);
    
    // 插入复选框到第6列
    sheet.getRange(newRow, 6).insertCheckboxes();
    
    // 清空需要空白的列（对应需求里的Session时间、telehealth项）
    sheet.getRange(newRow, 3).clearContent();
    sheet.getRange(newRow, 4).clearContent();
    sheet.getRange(newRow, 5).clearContent();
    sheet.getRange(newRow, 8).clearContent();
  }
}

代码说明 #

1. onEdit用了事件对象e，比直接获取活动范围更可靠，避免并发编辑问题
2. 加了复选框验证：确保只有编辑复选框单元格时才触发，防止误操作
3. insertRowsAfter直接在选中行下方插入新行，完全符合需求
4. 逐个设置单元格值，比appendRow更灵活，能精准控制每一列的内容和格式

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