Google Sheets Apps Script数组处理与跨表数据导出问题求助

核心错误原因 #

• 1. getRange调用错误：getRange()是Sheet工作表对象的方法，你最初直接在Spreadsheet工作簿对象ss上调用，且未传全「起始行、起始列、行数、列数」4个必要参数时会抛出找不到方法的错误。另外你早期代码里把ssStats存为工作表名称字符串，而非Sheet实例，也会导致后续调用方法失败。
• 2. 数组结构错误：getValues()永远返回二维数组，即使只读1行数据，返回结构也是[[列1值, 列2值,...]]。你直接对这个二维数组执行unshift(时间戳)，会得到结构为[时间戳, [列1值, 列2值,...]]的一维数组，appendRow()接收的是平级一维数组（每个元素对应一列），所以第二个元素被识别为数组对象，写入时就显示为[Ljava.lang.Object;@xxx类的内存地址乱码。
• 3. 性能问题：循环中反复调用getRange()读单格/单行数据会大幅降低脚本执行速度，单次读取全表数据再做数组操作是更合理的方案。

修复后完整代码 #

function saveStats() {
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  // 1. 获取目标工作表实例（注意名称是Transfer_Stats还是Transfer-Stats，和你表名一致即可）
  const transferSheet = ss.getSheetByName('Transfer_Stats');
  const lastStatsRow = transferSheet.getLastRow();
  const lastStatsCol = transferSheet.getLastColumn();
  const nameColIndex = 1; // 对应你原来的第2列，数组从0开始所以减1
  const timeStamp = Utilities.formatDate(new Date(), "MST", "yyyy-MM-dd'/'HH:mm:ss");

  // 2. 一次性读取所有数据，避免循环读单元格
  const allData = transferSheet.getRange(2, 1, lastStatsRow - 1, lastStatsCol).getValues();

  // 3. 筛选+拼接时间戳，生成符合要求的数组
  const filteredData = allData.filter(row => {
    // 筛选两个姓名列都不为空的行
    return row[nameColIndex]?.toString().trim() !== "" && row[nameColIndex + 1]?.toString().trim() !== "";
  }).map(row => {
    // 把时间戳加到行首，展开原来的行元素避免嵌套数组
    return [timeStamp, ...row];
  });

  // 4. 写入当前文件的Filtered_Stats表
  let filterSheet = ss.getSheetByName("Filtered_Stats");
  if (filterSheet) ss.deleteSheet(filterSheet);
  filterSheet = ss.insertSheet("Filtered_Stats");
  // 批量写入比循环appendRow效率高很多
  if (filteredData.length > 0) {
    filterSheet.getRange(1, 1, filteredData.length, filteredData[0].length).setValues(filteredData);
  }

  // --- 如果你要写到独立工作簿，替换上面第4步代码即可，示例：
  // const targetSS = SpreadsheetApp.openById("你独立工作簿的ID"); // 注意需要授权
  // const targetSheet = targetSS.getSheetByName("对应工作表名");
  // const targetLastRow = targetSheet.getLastRow();
  // targetSheet.getRange(targetLastRow + 1, 1, filteredData.length, filteredData[0].length).setValues(filteredData);

  // 可选：切回Rounds表
  // ss.getSheetByName('Rounds').activate();
}

代码说明 #

• 一次性读取全表数据后操作，执行效率提升明显，也避免了频繁切换工作表、调用API的错误
• 用filter筛选非空行，map拼接时间戳时用展开运算符...把原来的行元素平铺开，不会出现嵌套数组，写入后每个字段都会正常显示
• 批量写入setValues一次完成操作，不会出现逐行写入的卡顿问题

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