Google Apps Script中跨函数共享Sheet读取数组的问题

核心原因 #

Google Apps Script的每次函数调用都是独立的执行上下文，全局变量在每次函数运行时都会重新初始化。也就是说，你在A函数里更新的全局tavern数组，当调用B函数时，脚本会从头加载，全局变量被重置为空数组，自然读不到之前的数据。

可行解决方案 #

1. 封装读取逻辑，按需调用（推荐，适合数据可能更新的场景） #

把读取表格数据的逻辑做成独立函数，其他需要用tavern的函数直接调用这个函数获取最新数据：

// 封装读取tavern数据的函数
function getTavernData() {
  // 替换成你的表格名称
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("TavernSheet");
  // 获取表格所有数据（根据需要调整范围）
  return sheet.getDataRange().getValues();
}

// 示例函数1：使用tavern数据
function processTavernCards() {
  const tavern = getTavernData();
  console.log(tavern);
  // 你的卡牌处理逻辑
}

// 示例函数2：另一个使用tavern的函数
function displayTavernCards() {
  const tavern = getTavernData();
  // 你的展示逻辑
}

2. 用PropertiesService存储数据（适合数据不频繁更新的场景） #

如果表格数据不会经常变动，可以把读取到的tavern数组转成JSON字符串存储到脚本属性中，其他函数读取时再解析回来：

// 加载并存储tavern数据
function loadAndStoreTavern() {
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("TavernSheet");
  const tavern = sheet.getDataRange().getValues();
  // 存储到脚本属性
  PropertiesService.getScriptProperties().setProperty("tavernData", JSON.stringify(tavern));
  console.log(tavern);
}

// 其他函数获取存储的tavern数据
function useStoredTavern() {
  const storedJson = PropertiesService.getScriptProperties().getProperty("tavernData");
  const tavern = JSON.parse(storedJson);
  console.log(tavern);
  // 你的逻辑
}

注意：PropertiesService存储有大小限制（脚本属性总存储量不超过100KB），如果tavern数组很大，不建议用这个方法。

3. 同一执行流程内传递参数（适合主函数调用多个子函数的场景） #

如果是通过一个主函数触发多个子函数执行，可以把tavern作为参数直接传递给子函数：

function mainGameFlow() {
  // 先读取tavern数据
  const tavern = getTavernData();
  // 传递给子函数
  initGame(tavern);
  drawCards(tavern);
}

function initGame(tavern) {
  // 初始化游戏逻辑，使用tavern数组
}

function drawCards(tavern) {
  // 抽卡逻辑，使用tavern数组
}

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