如何优化AppScript中指定名称优先的列排序函数？

原代码的问题主要是频繁读写单个单元格（每次getRange/setValue都是远程API调用，耗时极高），而且用替换数字再还原的逻辑确实绕。下面给两种更高效清晰的优化方案，核心都是用批量数据操作+自定义排序逻辑。

方案一：拆分合并数组（直观易理解） #

这种方式把数据拆成「目标名称行」和「其他行」，直接合并后写回，逻辑一目了然：

function sortTargetNameFirst() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const targetName = "Name in question"; // 替换成你的目标名称
  const startRow = 2; // 假设表头在第1行，数据从第2行开始
  const lastRow = sheet.getLastRow();
  const lastCol = sheet.getLastColumn();
  
  // 一次性读取所有数据到数组（关键：减少API调用）
  const data = sheet.getRange(startRow, 1, lastRow - startRow + 1, lastCol).getValues();

  // 拆分数据：把目标名称的行和其他行分开
  const targetRows = [];
  const otherRows = [];
  
  data.forEach(row => {
    row[0] === targetName ? targetRows.push(row) : otherRows.push(row);
  });

  // 可选：如果需要其他行按名称排序，解开下面这行注释
  // otherRows.sort((a, b) => a[0].localeCompare(b[0]));

  // 合并数组：目标行在前，其余行在后
  const sortedData = [...targetRows, ...otherRows];

  // 一次性写回工作表（再次减少API调用）
  sheet.getRange(startRow, 1, sortedData.length, lastCol).setValues(sortedData);
}

方案二：自定义排序函数（更简洁） #

直接用数组的sort方法写自定义比较规则，一行搞定排序逻辑：

function sortTargetNameFirst() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const targetName = "Name in question";
  const startRow = 2;
  const lastRow = sheet.getLastRow();
  const lastCol = sheet.getLastColumn();
  
  const data = sheet.getRange(startRow, 1, lastRow - startRow + 1, lastCol).getValues();

  // 自定义排序规则：目标名称排最前，其余按名称升序
  data.sort((rowA, rowB) => {
    if (rowA[0] === targetName) return -1; // 目标行优先级更高，排前面
    if (rowB[0] === targetName) return 1;
    return rowA[0].localeCompare(rowB[0]); // 其余行按名称字母排序
  });

  sheet.getRange(startRow, 1, data.length, lastCol).setValues(data);
}

优化点说明 #

• 速度提升：把多次单元格读写改成1次读+1次写，API调用次数从2*(lastRow-1)降到2次，执行速度会快好几倍
• 逻辑简化：不用临时替换值再还原，直接对数据数组操作，代码可读性更强
• 灵活性高：可以轻松调整其余行的排序规则（比如按降序、按其他列排序）

内容的提问来源于stack exchange，提问作者Antonio Fernandez Espinosa