Google Apps Script：日历事件增改脚本报错排查（TypeError）

错误原因 #

出现TypeError: Cannot read property 'setDescription' of undefined的核心原因如下：

1. 拼写错误：判断事件数组长度时写了events.lenght，正确拼写应为events.length。这个错误导致空数组的判断逻辑失效，即便当天没有事件，也会进入else分支，此时events[0]为undefined，调用setDescription就会报错。
2. 索引不匹配：getRange的行参数是1-based，但forEach的index是0-based。跳过表头（index=0）后，index从1开始，此时getRange(index, ...)取的是表格第index行（对应错误数据行），而非目标数据行。
3. 冗余的getRange调用：已经通过getDataRange().getValues()获取了所有数据，反复调用getRange会降低脚本效率且易出错。
4. 未声明变量：ev未用var/let声明，会成为全局变量，存在潜在风险。

修正后的代码 #

function updatecal(){
  var cal = CalendarApp.getCalendarById('c_lmsj3r1ogsaafhc68gfalstdco@group.calendar.google.com');
  var dataSheet = SpreadsheetApp.getActive().getSheetByName("Data For Calendar");
  const rows = dataSheet.getDataRange().getValues();
  
  rows.forEach(function(row, index){
    // 跳过表头行
    if (index === 0) return;
    
    // 直接从row数组取数据，避免重复调用getRange
    const eventTitle = row[0]; // A列：事件标题
    const eventDescription = row[1]; // B列：事件描述
    const eventDate = new Date(row[3]); // D列：事件日期
    
    // 获取当天的所有事件
    const events = cal.getEventsForDay(eventDate);
    
    if (events.length === 0) {
      // 无事件则创建全天事件
      cal.createAllDayEvent(eventTitle, eventDate, {description: eventDescription});
    } else {
      // 有事件则更新第一个事件的描述
      let ev = events[0];
      ev.setDescription(eventDescription);
      // 可选：如果需要同步标题，添加 ev.setTitle(eventTitle);
    }
  });
}

额外说明 #

• 若需要同步更新事件标题，在else分支中添加ev.setTitle(eventTitle);即可。
• 确保谷歌表格D列是有效的日期格式，避免new Date(row[3])生成无效日期导致获取事件失败。

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