Google Apps Script 基于mastersheet行数据批量创建工作表的问题排查

原代码的核心错误点 #

• 执行顺序完全颠倒：获取swimmerName、行数据col、工作表引用sheet的逻辑全部写在循环外部，在循环启动前就执行完毕，根本无法拿到每一行的动态姓名和对应数据
• 循环起始索引错位：代码中循环从i=1开始遍历，而通过getRange('A2:B').getValues()拿到的数组，索引0恰好对应主表第2行的首条有效数据，从i=1开始直接跳过首条数据，天然造成行号错位，出现“新建表存了下一行数据”的现象
• 工作表引用未动态更新：循环内从未根据当前行的姓名重新检查对应工作表是否存在，仅在循环外调用一次getSheetByName拿到空值，后续循环中sheet变量始终没有更新，因此全程只创建一个工作表
• 写入参数不符合API要求：
  • col是长度为2的一维数组（对应单行A、B列的值），代码中错误用col.length作为写入行数、col[0].length作为写入列数传参，完全不符合getRange的入参规则
  • setValues方法要求传入二维数组，直接传入一维数组会触发类型错误
• var变量提升引发的隐式bug：由于var声明的变量存在提升机制，循环外定义的swimmerName、i、col本质属于函数顶层作用域，循环判断阶段的swimmerName实际为未定义状态，所有存在性判断逻辑全部失效

实现预期功能的修正代码 #

function createNewSheets() {
  const activeSpreadsheet = SpreadsheetApp.getActiveSpreadsheet();
  // 读取mastersheet中从A2开始的所有A、B列有效数据
  const masterRows = activeSpreadsheet.getSheetByName('mastersheet').getRange('A2:B').getValues();

  // 逐行遍历所有有效录入数据
  for (let i = 0; i < masterRows.length; i++) {
    const currentRowData = masterRows[i];
    const targetName = currentRowData[0];
    // 跳过无姓名的空行，避免生成无效工作表
    if (!targetName) continue;

    // 逐行检查对应姓名的工作表是否存在
    let targetSheet = activeSpreadsheet.getSheetByName(targetName);
    if (!targetSheet) {
      // 不存在时新建与当前行姓名同名的工作表
      targetSheet = activeSpreadsheet.insertSheet(targetName);
    }

    // 将当前行的A、B列数据写入工作表，按要求包为二维数组适配setValues格式
    targetSheet.getRange(1, 1, 1, currentRowData.length).setValues([currentRowData]);
  }
}

修正后逻辑与需求的匹配说明 #

• 遍历从数组索引0开始，与主表第2行的首条有效数据一一对应，不会出现行错位、跳过首行数据的问题
• 每遍历一行都会动态提取当前行的姓名，检查对应工作表是否存在，不存在才新建，确保每个姓名对应一个独立工作表
• 写入时严格匹配getRange的入参规则，适配setValues对二维数组的格式要求，不会触发参数类型错误
• 增加空行过滤逻辑，避免主表尾部的空白单元格触发无效工作表创建。

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