Google Apps Script报错TypeError: file1(...).copyColumns.copyTo is not a function的排查求助

这个错误 TypeError: file1(...).copyColumns.copyTo is not a function 背后其实是几个容易忽略的小问题叠加导致的，我帮你逐一拆解并修复：

核心问题排查 #

1. 全局变量污染
   你在file1和file2中定义的copyColumns、sheetsNames等变量没有用let/const声明，导致它们变成了全局变量。每次调用file1()或file2()时，这些全局变量会被重置，在agg_test的循环里反复调用这两个函数，会导致copyColumns数组的内容被频繁覆盖，最终出现无效对象调用copyTo的情况。

2. 重复调用函数的低效与冲突
   agg_test的循环里每次都重新调用file1()和file2()，这不仅会重复执行打开工作表、获取范围等耗时操作，还会因为全局变量的问题，每次返回的copyColumns和pasteColumns都是全新生成的，甚至可能出现数组长度不匹配的情况。

3. 表头范围获取的逻辑错误
   你用getRange(headerRow,1,headerRow,lastCol)获取表头时，第三个参数误用了headerRow（行号）作为行数——表头只有一行，这里应该固定为1；同时headerRow被赋值为字符串'1'，虽然GAS会自动转换，但规范上应该使用数字类型。

修改后的完整代码 #

File 1 脚本（源工作表处理） #

function file1() {
  const url = "Workbook 1 url";
  const sheet = "sheet to copy from";
  const selected_columns = ['Column 1 Name', 'Column 2 Name', 'Column 3 Name'];
  const headerRow = 1; // 改为数字类型，符合GAS参数要求
  const file = SpreadsheetApp.openByUrl(url);
  let copyColumns = []; // 用let声明局部变量，避免全局污染
  const sheetsNames = [];
  
  // 获取所有工作表名称
  const sheets = file.getSheets();
  for (let i = 0; i < sheets.length; i++) {
    sheetsNames.push(sheets[i].getName());
  }

  const selected_sheet = file.getSheetByName(sheet);
  const lastCol = selected_sheet.getDataRange().getLastColumn();
  // 仅获取表头一行的列名，直接提取数组简化后续操作
  const columns = selected_sheet.getRange(headerRow, 1, 1, lastCol).getValues()[0];

  for (let i = 0; i < selected_columns.length; i++) {
    const columnIndex = columns.indexOf(selected_columns[i]);
    if (columnIndex !== -1) {
      // 只复制有数据的行，避免空行浪费资源
      const columnRange = selected_sheet.getRange(
        headerRow, 
        columnIndex + 1, 
        selected_sheet.getLastRow() - headerRow + 1
      );
      copyColumns.push(columnRange);
      Logger.log(`匹配到源列：${columnIndex + 1}`);
    }
  }

  Logger.log(sheetsNames);
  Logger.log(selected_columns);
  Logger.log(copyColumns);
  return { url, sheet, copyColumns };
}

File 2 脚本（目标工作表处理） #

function file2() {
  const url = "workbook 2 url";
  const sheet = "sheet to paste in";
  const selected_columns = ['Column 1 Name', 'Column 2 Name', 'Column 3 Name'];
  const headerRow = 1;
  const file = SpreadsheetApp.openByUrl(url);
  let pasteColumns = [];
  const sheetsNames = [];
  
  const sheets = file.getSheets();
  for (let i = 0; i < sheets.length; i++) {
    sheetsNames.push(sheets[i].getName());
  }

  const selected_sheet = file.getSheetByName(sheet);
  const lastCol = selected_sheet.getDataRange().getLastColumn();
  const columns = selected_sheet.getRange(headerRow, 1, 1, lastCol).getValues()[0];

  for (let i = 0; i < selected_columns.length; i++) {
    const columnIndex = columns.indexOf(selected_columns[i]);
    if (columnIndex !== -1) {
      // 仅获取目标列的起始单元格，copyTo会自动匹配源数据范围
      const pasteRange = selected_sheet.getRange(headerRow, columnIndex + 1);
      pasteColumns.push(pasteRange);
      Logger.log(`匹配到目标列：${columnIndex + 1}`);
    }
  }

  Logger.log(sheetsNames);
  Logger.log(columns);
  Logger.log(selected_columns);
  Logger.log(pasteColumns);
  return { url, sheet, pasteColumns };
}

执行脚本（agg_test） #

function agg_test(){
  // 只调用一次源和目标函数，保存结果避免重复操作
  const sourceData = file1();
  const targetData = file2();
  
  Logger.log(sourceData.copyColumns);

  // 提前检查列数量是否匹配，避免索引越界错误
  if (sourceData.copyColumns.length !== targetData.pasteColumns.length) {
    Logger.log("错误：源列与目标列数量不匹配，请检查列名！");
    return;
  }

  // 循环复制数据
  for (let i = 0; i < sourceData.copyColumns.length; i++){
    // 指定粘贴类型为值，避免格式冲突（可根据需求调整）
    sourceData.copyColumns[i].copyTo(
      targetData.pasteColumns[i], 
      SpreadsheetApp.CopyPasteType.PASTE_VALUES, 
      false
    );
  }
  Logger.log("数据复制完成！");
}

关键修改点说明 #

• 局部变量声明：所有变量都用let/const声明，彻底避免全局变量带来的冲突问题。
• 优化范围获取：源列只复制有数据的行（用getLastRow()替代getMaxRows()），目标列仅获取起始单元格，减少不必要的资源消耗。
• 减少重复调用：在执行脚本中一次性获取源和目标数据，避免循环中反复打开工作表。
• 添加错误检查：提前验证源列和目标列的数量是否匹配，快速定位列名不匹配的问题。

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