在 Google Apps Script (GAS) 开发 Google Workspace 插件时，经常会遇到需要在不同函数间共享和修改变量的情况。然而，GAS 的执行机制与传统的 JavaScript 有所不同，直接使用全局变量可能无法达到预期的效果。这是因为每次函数调用都被视为独立的执行，全局变量会被重新初始化。

问题分析

GAS 中，每次通过 UI 触发的函数调用，例如点击卡片上的按钮，都会启动一个新的脚本执行。这意味着在 onOpen() 函数中定义的全局变量 startdate 在 reviseStartDate() 函数中会被重新初始化为初始值，而不是保留 createCard() 函数中修改后的值。

解决方案：使用 CacheService

CacheService 提供了一种在脚本执行之间缓存数据的方式。我们可以利用它来存储需要在不同函数间共享的变量。

示例代码：

var cache = CacheService.getUserCache();

function onHomepage() {
  var card = createCard();
  return card;
}

function createCard() {
  cache.put("startdate", "tomorrow"); // 将 startdate 的值存储到缓存中
  var startdate = cache.get("startdate"); // 从缓存中读取 startdate 的值

  var button = CardService.newTextButton()
    .setText('Revise start date')
    .setOnClickAction(CardService.newAction()
      .setFunctionName('reviseStartDate'));

  var section = CardService.newCardSection()
    .addWidget(button);

  var card = CardService.newCardBuilder()
    .setHeader(CardService.newCardHeader().setTitle('Default start: ' + startdate))
    .addSection(section)

  return card.build();
}

function reviseStartDate() {
  var startdate = cache.get("startdate"); // 从缓存中读取 startdate 的值

  var card = CardService.newCardBuilder()
    .setHeader(CardService.newCardHeader().setTitle("Revised start: " + startdate));

  return card.build();
}

代码解释：

1. 获取缓存服务： var cache = CacheService.getUserCache(); 获取当前用户的缓存服务。
2. 存储变量： cache.put("startdate", "tomorrow"); 将 startdate 的值 "tomorrow" 存储到缓存中，键为 "startdate"。
3. 读取变量： var startdate = cache.get("startdate"); 从缓存中读取键为 "startdate" 的值，并将其赋值给变量 startdate。

通过使用 CacheService，我们可以确保 reviseStartDate() 函数能够获取到 createCard() 函数中修改后的 startdate 值。

注意事项：

javascript-typescript-typescript-scaffold

你是 TypeScript 项目架构专家，专注于脚手架搭建生产就绪的 Node.js 和前端应用。生成包含现代工具链（pnpm、Vite、Next.js）、类型

下载

• CacheService 存储的数据有一定的有效期，过期后会被自动清除。默认有效期为 6 小时。
• CacheService 适合存储少量的数据，不适合存储大量数据。

替代方案：使用 User Properties

除了 CacheService，还可以使用 User Properties 来存储需要在不同函数间共享的变量。User Properties 允许您为每个用户存储键值对，这些键值对在用户的脚本执行之间保持持久性。

示例代码：

var userProperties = PropertiesService.getUserProperties();

function onHomepage() {
  var card = createCard();
  return card;
}

function createCard() {
  userProperties.setProperty("startdate", "tomorrow"); // 将 startdate 的值存储到 User Properties 中
  var startdate = userProperties.getProperty("startdate"); // 从 User Properties 中读取 startdate 的值

  var button = CardService.newTextButton()
    .setText('Revise start date')
    .setOnClickAction(CardService.newAction()
      .setFunctionName('reviseStartDate'));

  var section = CardService.newCardSection()
    .addWidget(button);

  var card = CardService.newCardBuilder()
    .setHeader(CardService.newCardHeader().setTitle('Default start: ' + startdate))
    .addSection(section)

  return card.build();
}

function reviseStartDate() {
  var startdate = userProperties.getProperty("startdate"); // 从 User Properties 中读取 startdate 的值

  var card = CardService.newCardBuilder()
    .setHeader(CardService.newCardHeader().setTitle("Revised start: " + startdate));

  return card.build();
}

代码解释：

1. 获取 User Properties 服务： var userProperties = PropertiesService.getUserProperties(); 获取当前用户的 User Properties 服务。
2. 存储变量： userProperties.setProperty("startdate", "tomorrow"); 将 startdate 的值 "tomorrow" 存储到 User Properties 中，键为 "startdate"。
3. 读取变量： var startdate = userProperties.getProperty("startdate"); 从 User Properties 中读取键为 "startdate" 的值，并将其赋值给变量 startdate。

注意事项：

• User Properties 存储的数据没有有效期限制，会一直存在，直到手动删除。
• User Properties 适合存储用户的配置信息等需要长期保存的数据。

总结

在 Google Apps Script 中跨函数引用变量时，需要注意 GAS 的执行机制。可以使用 CacheService 或 User Properties 来存储需要在不同函数间共享的变量。CacheService 适合存储临时数据，而 User Properties 适合存储需要长期保存的数据。选择哪种方式取决于具体的应用场景和需求。

通过本文的学习，相信您已经掌握了在 Google Apps Script 中跨函数引用变量的正确方法，能够更加高效地开发 Google Workspace 插件。