GAS运行脚本偶发跳过代码无报错 如何实现脚本稳定执行

问题根因 #

你遇到的问题和JS异步机制无关，Google Apps Script的内置服务（比如SpreadsheetApp）默认是同步阻塞执行的，出现代码"跳过"、操作无理由失效且不报错的核心原因如下：

• 代码全程依赖setActiveSheet()、getActiveSheet()这类全局活动状态方法做逻辑中转，GAS脚本和表格前端的状态同步存在延迟，上一步切换活动表的指令还没在前端生效，脚本已经开始执行下一句操作，就会出现操作打在错误工作表、部分操作没生效的现象，表现出来和跳过代码行完全一致
• 原代码存在笔误：getSheetByName('emplate 1')漏写了模板名开头的t，本身就会导致找不到目标工作表的异常
• 你尝试用async/await解决问题无效是正常的：GAS内置服务的方法不会返回Promise，async/await只对Promise对象生效，套在同步方法上没有任何实际作用，所以IDE会提示语法不必要。

修复方案 #

核心原则：业务逻辑永远不要依赖活动状态中转，所有工作表、范围都提前获取固定对象引用，直接操作引用对象，不要通过全局active类方法做链式操作；涉及表结构修改（复制、移动、重命名、隐藏工作表）的操作完成后，调用SpreadsheetApp.flush()强制提交所有待执行的操作，避免操作队列堆积导致的执行错乱。

修复后的可稳定运行代码如下：

function onOpen() {
  var ui = SpreadsheetApp.getUi();
  ui.createMenu('Create new list from template')
    .addItem('template 1', 'menuItem1')
    .addItem('template 2', 'menuItem2')
    .addToUi();
}

function menuItem1() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  // 提前获取模板表固定引用，修正原代码笔误
  const templateSheet = ss.getSheetByName('template 1');
  if (!templateSheet) throw new Error('模板表template 1不存在，请检查配置');
  // 直接基于模板表复制，拿到新表的固定引用，全程不依赖活动表状态
  const newSheet = templateSheet.duplicate();
  const totalSheetCount = ss.getSheets().length;
  // 直接操作新表引用完成移动、重命名
  newSheet.moveTo(totalSheetCount);
  newSheet.setName(`yyyy-MM-dd ${totalSheetCount}`);
  // 直接操作模板表引用完成隐藏
  templateSheet.hideSheet();
  // 强制提交所有操作，确保全部生效
  SpreadsheetApp.flush();
}

修复点说明 #

• 移除了所有setActiveSheet、getActiveSheet、getActive相关的调用，从根源避免GAS和表格前端状态不同步导致的操作错位
• 复制工作表后直接拿到新生成表的对象引用，后续所有操作都基于该引用执行，不会出现操作错对象的问题
• 增加了模板表存在性校验，出现配置问题时会直接抛出明确错误，方便排查
• 末尾加flush()方法强制同步所有操作到表格端，避免操作队列延迟导致的部分指令丢失

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