使用Google Apps Script数组重排电子表格数据未生效问题

架构老林

2026-8-27

核心错误点

代码运行后没有产生任何预期修改，全部由以下几个逻辑错误导致：

所有赋值操作误写为相等判断：所有你以为在修改数组值的位置，比如rows[h][9] == ''、rows[p][9] == filteredArray[r][3]，用的都是相等比较运算符==，这类语句只会返回true/false的判断结果，根本不会修改数组内的实际值，这是数组没有任何变更的核心原因。
待匹配数据结构错误：你存入filteredArray的每条记录是多层嵌套的二维数组，后续匹配时取到的filteredArray[r][0]是包裹了值的单元素数组，不是需要比对的原始字符串，所有匹配判断永远不会成立。
匹配逻辑未做值统一：你只对写回表格的B、C列做了大小写、重音字符清理，内存中用于匹配判断的rows数组里的B、C、H、N列值没有做同样的标准化，只要存在大小写差异、重音字符、多余空格，就会匹配失败。
回写范围硬编码错误：最后回写数据时你硬编码了A1:U的范围，和getDataRange()拿到的rows数组列数不一定匹配，很容易触发维度不匹配报错，就算不报错也可能出现数据错位。
循环索引边界不准：遍历行时用lastRow做终止条件，但rows数组的长度是getDataRange()返回的实际总行数，二者如果存在偏差会导致漏遍历或者数组越界。

修正后可直接运行代码

function reordenarFacturas(){
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  const sheet = ss.getSheetByName('AP que esperan');
  const dataRange = sheet.getDataRange();
  const rows = dataRange.getValues();
  const lastRow = rows.length;
  const filteredArray = [];

  // 值标准化工具函数：统一大小写、替换重音、去除多余空格，避免匹配失效
  const normalizeValue = (val) => {
    if (val === '' || val == null) return '';
    return val.toString()
      .toUpperCase()
      .replace(/á/ig, 'A')
      .replace(/é/ig, 'E')
      .replace(/í/ig, 'I')
      .replace(/ó/ig, 'O')
      .replace(/ú/ig, 'U')
      .replace(/\s+/g, ' ') // 替换所有连续多空格为单个空格
      .trim();
  };

  // 【可选配置】如果不需要修改原表B/C列的原始格式，把下面这段清理写回的代码注释掉即可
  const nombresAP = [];
  for (let h = 2; h < lastRow; h++) {
    nombresAP.push([
      normalizeValue(rows[h][1]),
      normalizeValue(rows[h][2])
    ]);
  }
  if (nombresAP.length > 0) {
    sheet.getRange(3, 2, nombresAP.length, 2).setValues(nombresAP);
    // 同步更新内存中rows数组的B/C列值，保证匹配一致
    for (let i = 0; i < nombresAP.length; i++) {
      rows[i+2][1] = nombresAP[i][0];
      rows[i+2][2] = nombresAP[i][1];
    }
  }

  // 收集所有需要迁移的数据行
  for (let h = 2; h < lastRow; h++) {
    // J列（索引9）为空直接跳过
    if (rows[h][9] === '') continue;
    // H列（索引7）和N列（索引13）值一致不需要迁移
    if (normalizeValue(rows[h][7]) === normalizeValue(rows[h][13])) continue;

    // 存入待迁移数据，结构为一维对象，避免嵌套取值错误
    filteredArray.push({
      matchKey: `${normalizeValue(rows[h][1])}|${normalizeValue(rows[h][2])}|${normalizeValue(rows[h][13])}`,
      data: [
        rows[h][9],  // J列
        rows[h][10], // K列
        rows[h][11], // L列
        rows[h][12], // M列
        rows[h][13]  // N列
      ]
    });

    // 清空原行J-N列内容，使用=赋值
    rows[h][9] = '';
    rows[h][10] = '';
    rows[h][11] = '';
    rows[h][12] = '';
    rows[h][13] = '';
  }

  // 匹配目标行，写入迁移数据
  for (let p = 2; p < lastRow; p++) {
    const targetKey = `${normalizeValue(rows[p][1])}|${normalizeValue(rows[p][2])}|${normalizeValue(rows[p][7])}`;
    for (let r = 0; r < filteredArray.length; r++) {
      if (targetKey === filteredArray[r].matchKey) {
        // 写入J-N列，使用=赋值
        rows[p][9] = filteredArray[r].data[0];
        rows[p][10] = filteredArray[r].data[1];
        rows[p][11] = filteredArray[r].data[2];
        rows[p][12] = filteredArray[r].data[3];
        rows[p][13] = filteredArray[r].data[4];
        break; // 匹配到即跳出循环，避免重复覆盖
      }
    }
  }
  
  // 按原始数据范围回写，不硬编码列范围避免维度错误
  dataRange.setValues(rows);
}

使用说明

代码默认保留了你原来对B、C列做特殊字符清理后写回表格的逻辑，如果不需要修改B、C列的原始内容，直接把代码中标注了可选配置的那段代码注释掉即可，匹配环节的值标准化仅在内存中运行，不会影响原表数据。
匹配逻辑完全符合需求：目标行B、C、H列的值标准化后，和待迁移行B、C、N列的值标准化后完全一致时，就把待迁移行J到N列的内容移到目标行对应位置，同时清空原行的这部分内容。
首次运行前建议先复制一份表格做备份，避免误操作丢失数据。

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