Google Sheets脚本：B4日期变更时移动指定区域列左移失效排查

一、原脚本的核心问题 #

1. 功能逻辑完全错误 #

你要实现的是将C5:OG22区域的列向左移动一列，但原代码用了insertColumnsBefore——这是在目标区域左侧插入新列，和需求完全反向。

2. 冗余代码加空值风险 #

原代码先通过getSheetByName("MASTER")获取指定工作表，转头又判断sheet.getName() == "MASTER"，属于冗余操作。而且如果找不到“MASTER”工作表，sheet会变为null，此时调用sheet.getName()会直接触发报错导致脚本崩溃。

3. 手动测试报错的原因 #

onEdit(e)是Google表格的自动触发函数，只有当用户手动编辑表格时，系统才会自动传入e事件参数。直接在脚本编辑器中运行该函数时，e参数不存在，调用e.range自然会抛出“无法读取undefined属性”的错误。

二、修复后的可用脚本 #

function onEdit(e) {
  // 无事件参数直接退出（避免手动运行报错）
  if (!e) return;

  const targetSheet = e.range.getSheet();
  // 校验是否是MASTER表的B4单元格被编辑
  if (targetSheet.getName() !== "MASTER" || e.range.getA1Notation() !== "B4") {
    return;
  }

  // 定义要左移的区域和左移后的目标区域
  const sourceRange = targetSheet.getRange("C5:OG22");
  const targetRange = targetSheet.getRange("B5:OF22");

  // 将源区域内容复制到左侧一列，再清空原区域
  sourceRange.copyTo(targetRange, SpreadsheetApp.CopyPasteType.PASTE_VALUES, false);
  sourceRange.clearContent();
}

三、手动测试的方法 #

直接运行onEdit会报错，需要写测试函数模拟触发场景：

function testOnEdit() {
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("MASTER");
  if (!sheet) {
    console.log("找不到MASTER工作表");
    return;
  }
  // 模拟B4单元格被编辑的事件对象
  const mockEvent = {
    range: sheet.getRange("B4")
  };
  // 调用onEdit函数
  onEdit(mockEvent);
}

运行这个testOnEdit函数，就能验证脚本的实际效果。

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