Google Apps Script中函数每次执行时如何正确递增全局变量？

以下改编的Google Apps Script代码可将name和count写入对应单元格，但count值始终保持为0，无法实现每次执行AddRecord时递增：

var count = 0;

function AddRecord(name) {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheetByName("data");
  var cell = sheet.getRange("F5");
  cell.setValue(name); 
  cell = sheet.getRange("B2");
  cell.setValue(count);
  count = count + 1;
}

function startForm() {
  var form = HtmlService.createHtmlOutputFromFile('AddForm');
  SpreadsheetApp.getUi().showModalDialog(form, 'Add Record');
}

function addMenu() {
  var menu = SpreadsheetApp.getUi().createMenu('Custom');
  menu.addItem('Add Record Form', 'startForm');
  menu.addToUi();
}

function onOpen(e) {
  addMenu();
}

问题原因 #

Google Apps Script的全局变量每次函数执行完毕后会被重置，所以每次调用AddRecord时，count都会重新初始化为0，无法保留之前的递增结果。

解决方案 #

方案1：用单元格存储计数值（最可靠）

将计数值持久化存储在表格的某个单元格中，每次读取当前值、递增后再写回，彻底解决状态丢失问题：

function AddRecord(name) {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheetByName("data");
  
  // 写入name到F5
  sheet.getRange("F5").setValue(name);
  
  // 处理计数逻辑：读取B2当前值，递增后更新
  var countCell = sheet.getRange("B2");
  var currentCount = countCell.getValue() || 0; // 单元格为空时初始化为0
  countCell.setValue(currentCount);
  countCell.setValue(currentCount + 1); // 递增后写入单元格
}

// 其余函数保持不变
function startForm() {
  var form = HtmlService.createHtmlOutputFromFile('AddForm');
  SpreadsheetApp.getUi().showModalDialog(form, 'Add Record');
}

function addMenu() {
  var menu = SpreadsheetApp.getUi().createMenu('Custom');
  menu.addItem('Add Record Form', 'startForm');
  menu.addToUi();
}

function onOpen(e) {
  addMenu();
}

方案2：闭包实现内存计数（极简方案）

利用闭包特性在内存中保留计数状态，但注意：脚本长时间闲置时，内存状态可能被清除，可靠性不如单元格存储。对应的极简代码翻译及实现：

// 闭包计数器：初始化count为0，返回一个每次调用都会递增count的函数
const counter = (() => {
  let count = 0;
  return () => count++;
})();

function AddRecord(name) {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheetByName("data");
  
  sheet.getRange("F5").setValue(name);
  sheet.getRange("B2").setValue(counter()); // 调用counter()获取递增后的数值
}

// 其余函数保持不变

闭包原理：立即执行函数创建私有作用域，内部的count变量不会被外部访问，也不会在函数执行后被销毁，每次调用返回的匿名函数时，都会更新并返回这个私有count的值。

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