如何阻止Google Sheet脚本函数在首次运行时被重复执行

方法1：用LockService实现并发控制（官方推荐） #

这是最可靠的方案，Google Apps Script自带的LockService能创建文档级锁，确保同一时间只有一个脚本实例运行。

function yourButtonFunction() {
  // 获取文档级锁，设置等待时间0毫秒（拿不到锁直接放弃）
  const lock = LockService.getDocumentLock();
  if (!lock.tryLock(0)) {
    SpreadsheetApp.getUi().alert("脚本正在运行，请稍后再试！");
    return;
  }

  try {
    // --------------------------
    // 这里写你的核心业务逻辑
    // 示例：写入当前时间+模拟耗时操作
    const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Sheet1");
    sheet.getRange("A1").setValue(new Date());
    Utilities.sleep(5000);
    // --------------------------
  } finally {
    // 不管脚本成功还是失败，必须释放锁
    lock.releaseLock();
  }
}

用户第二次点击时，锁被占用，tryLock(0)会返回false，直接弹出提示并退出，不会重复执行核心代码。

方法2：用脚本属性存储运行状态 #

利用PropertiesService存储运行标记，脚本启动时检查标记，结束后清除标记。

function yourButtonFunction() {
  const props = PropertiesService.getScriptProperties();
  const isRunning = props.getProperty("IS_RUNNING");

  if (isRunning === "true") {
    SpreadsheetApp.getUi().alert("脚本正在执行中，别重复点啦！");
    return;
  }

  try {
    // 设置运行标记
    props.setProperty("IS_RUNNING", "true");
    // --------------------------
    // 核心业务逻辑
    const sheet = SpreadsheetApp.getActiveSheet();
    sheet.getRange("B1").setValue("运行中...");
    Utilities.sleep(5000);
    // --------------------------
  } finally {
    // 清除运行标记
    props.deleteProperty("IS_RUNNING");
  }
}

注意：如果脚本意外崩溃（比如超时报错），标记可能不会被清除，可加超时判断或写个重置标记的辅助函数手动处理。

方法3：用单元格做运行标记 #

如果不想用服务端存储，可在Sheet里找个隐藏单元格存状态，比如用Z列的某个单元格（记得隐藏Z列）。

function yourButtonFunction() {
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Sheet1");
  const statusCell = sheet.getRange("Z1"); // 用Z1存状态
  const isRunning = statusCell.getValue();

  if (isRunning === "RUNNING") {
    SpreadsheetApp.getUi().alert("脚本还在跑，稍等会儿！");
    return;
  }

  try {
    statusCell.setValue("RUNNING");
    // --------------------------
    // 核心业务逻辑
    sheet.getRange("C1").setValue(new Date());
    Utilities.sleep(5000);
    // --------------------------
  } finally {
    // 清空状态标记
    statusCell.clearContent();
  }
}

这个方案直观，能直接在Sheet里看到脚本状态；缺点是如果用户手动修改该单元格，会影响逻辑。

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