基于两行表头比对的Google Sheets列数据迁移脚本问题排查

问题明确 #

需要实现的功能：从表格第四行（第三行起的数据行，索引从0开始为第3行）开始，数据列按照第一行表头的顺序重新排列；强制要求第三行表头保持原有顺序不修改，仅调整对应的数据列。现有脚本存在两个核心问题：第一行表头顺序错乱，第三行表头未保留原顺序。

现有问题常见原因 #

• 误将第一行/第三行表头纳入数据调整范围，导致表头被修改
• 未建立第一行表头与第三行表头的对应映射，数据列匹配逻辑错误
• 直接对整个表格列进行重排，未区分固定表头行与可调整数据行

修正后的完整代码 #

function adjustDataColumns() {
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
  const range = sheet.getDataRange();
  const values = range.getValues();
  
  // 提取关键行：第一行表头（目标排序依据）、第三行表头（固定顺序）
  const firstRowHeaders = values[0];
  const thirdRowHeaders = values[2]; // 数组索引从0开始，第三行对应索引2
  
  // 构建第三行表头到原列索引的映射，用于匹配数据
  const thirdHeaderColMap = {};
  thirdRowHeaders.forEach((header, idx) => {
    thirdHeaderColMap[header] = idx;
  });
  
  // 构建新数据数组：保留固定行，仅调整数据行
  const newValues = [];
  // 保留第一行表头（原顺序不变）
  newValues.push(firstRowHeaders);
  // 保留第二行（若存在，比如空行或辅助行）
  if (values.length > 1) newValues.push(values[1]);
  // 保留第三行表头（原顺序不变）
  newValues.push(thirdRowHeaders);
  
  // 处理第四行及以后的数据行（索引3开始）
  for (let i = 3; i < values.length; i++) {
    const currentRow = values[i];
    const adjustedRow = [];
    // 按第一行表头顺序，从原数据行中提取对应第三行表头匹配的列数据
    firstRowHeaders.forEach(targetHeader => {
      const colIndex = thirdHeaderColMap[targetHeader];
      adjustedRow.push(colIndex !== undefined ? currentRow[colIndex] : "");
    });
    newValues.push(adjustedRow);
  }
  
  // 覆盖写入新数据
  range.clearContent();
  sheet.getRange(1, 1, newValues.length, newValues[0].length).setValues(newValues);
}

代码核心说明 #

• 固定行保护：直接保留第一行、第二行、第三行的原始内容，完全避免表头被误修改
• 映射逻辑：通过第三行表头与原列索引的映射，确保数据列能精准匹配第一行表头的顺序
• 容错处理：若第一行表头在第三行中不存在，对应位置填充空字符串，避免脚本报错
• 性能优化：一次性读取/写入所有数据，减少Google Sheets API调用次数

效果验证 #

• 第一行表头保持原有顺序，无错乱
• 第三行表头完全保留初始顺序，未被修改
• 第四行及以后的数据列，严格按照第一行表头的顺序排列，与第三行表头的列对应关系完全匹配

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