如何确保Google Apps Script获取Google Sheet的最新变更？

阿华AIGC实验室

2026-5-15

解决Google Apps Script获取Google Sheet最新数据的问题

你遇到的这个问题其实挺常见的——当通过Sheet里的图片按钮触发脚本时，Google Sheets有时不会立刻把用户刚做的编辑同步到Apps Script的运行环境里，导致脚本拿到的是缓存的旧数据，完全没反映最新的变更。

核心解决方案：强制刷新Sheet变更

只需要在获取数据之前调用SpreadsheetApp.flush()方法就行，这个方法会强制把所有未保存的用户编辑写入Sheet，确保后续的数据读取操作能拿到最新内容。

修改后的`startSync`函数

把你的startSync函数更新成下面这样：

function startSync() { 
  // 强制刷新所有未保存的Sheet变更，确保拿到最新数据
  SpreadsheetApp.flush();
  
  // 获取当前活动工作表
  var sheet = SpreadsheetApp.getActiveSheet(); 
  SpreadsheetApp.getActiveSpreadsheet().toast('Synced.'); 
  // 获取有内容的行数和列数
  var [rows, columns] = [sheet.getLastRow(), sheet.getLastColumn()]; 
  // 获取指定范围的二维数组数据
  var data = sheet.getRange(1, 1, rows, columns).getValues(); 
  // 调用同步函数把数据推送到Firebase
  syncMasterSheet(data); 
}

为什么这能解决问题？

用户在Sheet里编辑单元格后，这些变更一开始只是存在客户端的临时缓存里，还没立刻同步到Google的服务器或者Apps Script的运行上下文。flush()方法会触发所有待处理的Sheet操作（包括用户的编辑）完成写入，这样后续的getLastRow()、getValues()等方法就能访问到最新的内容了。