Google Apps Script报错：TypeError: Cannot read properties of null (reading 'setTabColor')

错误根源 #

报错的直接原因是代码尝试对null对象调用setTabColor方法——因为spreadsheet.getSheetByName(categoryTab)没有找到对应工作表，返回了null。

具体问题出在工作表名称不匹配：

• 创建工作表时，你定义的tabs数组包含"Workout"
• 但后续设置颜色和表头的categoryTabs、tabsWithHeaders数组里写的是"Sports/Training"，两者名称不一致，导致找不到对应的工作表。

修复步骤 #

1. 统一工作表名称：将categoryTabs和tabsWithHeaders中的"Sports/Training"替换为"Workout"，和创建时的名称保持一致。
2. 添加空值校验（可选但推荐）：在对sheet对象执行操作前，先判断是否存在，避免因名称错误导致的崩溃。
3. 校验颜色数组索引：当前colorIndex = i + 1会跳过colors数组的第一个元素#ffffff，如果这不是你的预期，可以调整为colorIndex = i。

修复后的完整代码 #

function createTaskTracker() {
  // 创建新的Google Sheets文档
  var sheetName = "Task Tracker";
  var spreadsheet = SpreadsheetApp.create(sheetName);

  // 创建工作表标签
  var tabs = ["Overall", "Work", "Social Media", "Workout", "Freetime", "Long-Term Progress"];
  for (var i = 0; i < tabs.length; i++) {
    var tabName = tabs[i];
    spreadsheet.insertSheet(tabName);
  }

  // 设置标签颜色
  var colors = ["#ffffff", "#00ff00", "#0000ff", "#ffff00", "#ff0000"];
  var categoryTabs = ["Work", "Workout", "Freetime", "Social Media"]; // 修正名称
  for (var i = 0; i < categoryTabs.length; i++) {
    var categoryTab = categoryTabs[i];
    var colorIndex = i + 1; // 若要使用第一个颜色，改为i即可
    var sheet = spreadsheet.getSheetByName(categoryTab);
    // 空值校验
    if (sheet) {
      var color = colors[colorIndex];
      sheet.setTabColor(color);
    } else {
      console.log(`未找到工作表：${categoryTab}`);
    }
  }

  // 设置列标题
  var headers = ["Task", "Routine", "Time Spent", "Status", "Progress"];
  var tabsWithHeaders = ["Work", "Workout", "Freetime", "Social Media"]; // 修正名称
  for (var i = 0; i < tabsWithHeaders.length; i++) {
    var tabName = tabsWithHeaders[i];
    var sheet = spreadsheet.getSheetByName(tabName);
    if (sheet) {
      sheet.appendRow(headers);
    }
  }

  // 冻结首行
  for (var i = 0; i < tabs.length; i++) {
    var tabName = tabs[i];
    var sheet = spreadsheet.getSheetByName(tabName);
    if (sheet) {
      sheet.setFrozenRows(1);
    }
  }

  // 重命名默认工作表为Settings
  var defaultSheet = spreadsheet.getSheetByName("Sheet1");
  if (defaultSheet) {
    defaultSheet.setName("Settings");
  }

  // 在主标签添加欢迎信息
  var mainTab = spreadsheet.getSheetByName("Overall");
  if (mainTab) {
    mainTab.getRange("A1").setValue("Welcome to your Task Tracker!");
  }
}

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