Google Apps Script实现指定工作表批量复制到同文件夹电子表格

报错根因拆解 #

• 方法参数类型不匹配：Sheet.copyTo()强制要求传入目标电子表格的Spreadsheet类实例，原代码传入的是Drive文件迭代器对象，直接触发方法签名校验失败，抛出参数不匹配的异常。
• 复制逻辑错位：原代码在循环内遍历目标表格的现有工作表执行复制，没有将提前提取的源工作表作为复制主体，整体复制链路方向走反。
• 迭代器使用不规范：循环块内多次调用迭代器next()方法，会出现文件漏遍历的问题，且未排除源文件本身，容易在源表格中生成重复冗余的工作表副本。

修正后的可运行代码 #

function syncSheetToFolderSpreadsheets() {
  // 获取当前承载源工作表的电子表格实例
  const sourceSpread = SpreadsheetApp.getActiveSpreadsheet();
  // 提取索引为13的源目标工作表（注意：工作表索引从0开始计数）
  const sourceTargetSheet = sourceSpread.getSheets()[13];
  // 替换为实际的目标文件夹ID
  const targetFolder = DriveApp.getFolderById('替换为你的目标文件夹实际ID');
  // 获取文件夹下所有Google电子表格类型的文件迭代器
  const sheetFileIterator = targetFolder.getFilesByType(MimeType.GOOGLE_SHEETS);

  // 遍历所有目标电子表格
  while (sheetFileIterator.hasNext()) {
    // 单次取出当前遍历的文件实例，避免反复调用next()导致漏取文件
    const currentFile = sheetFileIterator.next();
    // 跳过源文件本身，避免在源文件内生成重复副本
    if (currentFile.getId() === sourceSpread.getId()) continue;
    
    // 将当前Drive文件打开为合规的Spreadsheet实例，满足copyTo的参数要求
    const targetSpread = SpreadsheetApp.open(currentFile);
    // 执行跨表格工作表复制
    sourceTargetSheet.copyTo(targetSpread);
  }
}

落地注意事项 #

• 索引计数规则：getSheets()返回的数组从0开始计数，[13]对应源表格内从左数第14个标签页。如果你的目标工作表在从左数第13个位置，需要将索引值调整为12，避免复制错工作表。
• 覆盖行为说明：如果目标电子表格内已存在与源工作表同名的标签页，copyTo方法会自动为新复制的工作表追加序号后缀（如“工作表副本”“工作表副本1”），不会覆盖原有内容。
• 权限配置：首次运行脚本时需要按照弹窗提示，授权脚本访问Google Drive和Google Sheets的读写权限，否则会触发权限类报错。

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