如何在Google Apps Script中向数组添加元素且避免事件触发时数组被重新声明？

这个问题其实是Google Apps Script（GAS）的核心特性导致的——GAS的执行是无状态的。每次触发函数（比如点击下拉按钮调用handelAdd），都会启动一个全新的执行环境，所有全局变量（比如你定义的let by = []）都会被重新初始化，所以之前添加的元素自然就丢失了。

要解决这个问题，你需要把数组数据持久化存储起来，GAS提供了几种轻量级的存储方案，最适合你这个场景的是PropertiesService，下面是具体的修改方案：

方案1：使用脚本属性（Script Properties）存储数组 #

脚本属性会把数据和当前脚本绑定，所有有权限运行这个脚本的用户都能访问到同一组数据。修改后的代码如下：

function addToArray(name = 'hello') {
  // 获取脚本属性服务
  const scriptProps = PropertiesService.getScriptProperties();
  
  // 读取已存储的数组，若不存在则初始化为空数组
  let by = JSON.parse(scriptProps.getProperty('byArray')) || [];
  
  // 处理并添加新元素
  const processedName = name.replace(/\s[\s\S]*/, '').toLowerCase();
  by.push(processedName);
  
  // 将更新后的数组转成JSON字符串存回脚本属性
  scriptProps.setProperty('byArray', JSON.stringify(by));
  
  console.log(by.join(', '));
}

function handelAdd() {
  const ui = DocumentApp.getUi();
  const response = ui.prompt('Name:');
  
  if (response.getSelectedButton() === ui.Button.OK) {
    // 修正了你原代码里的函数名错误（原代码写的是add，应该是addToArray）
    addToArray(response.getResponseText());
  }
}

// 可选：添加清空数组的函数，方便调试或重置
function clearStoredArray() {
  const scriptProps = PropertiesService.getScriptProperties();
  scriptProps.deleteProperty('byArray');
  console.log('数组已清空');
}

代码说明： #

• PropertiesService.getScriptProperties()：获取脚本级别的持久化存储，数据会一直保留，直到你主动删除或修改。
• JSON.parse/JSON.stringify：因为Properties只能存储字符串类型，所以需要把数组转换成JSON字符串来存储，读取时再解析回数组。
• 修正了原代码中的小错误：你调用的add()函数实际应该是addToArray()。

方案2：使用文档属性（Document Properties） #

如果你希望数组数据和当前Google文档绑定（不同文档的脚本不会共享这个数据），可以把PropertiesService.getScriptProperties()换成PropertiesService.getDocumentProperties()，其他代码逻辑完全一致。

为什么原代码不行？ #

再强调一下：GAS每次执行函数都是独立的会话，全局变量的生命周期只存在于当前函数执行过程中，执行结束后所有内存中的数据都会被销毁。所以你定义的let by = []每次触发事件都会重新变成空数组，自然无法保留之前添加的元素。

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