如何通过Apps Script在含同名多行的已排序表格中添加记录？

针对你遇到的问题，核心思路是先把表格里的非结构化数据（A列仅首行有记录名）转换成结构化的键值对，这样不管排序还是新增数据都能轻松处理，完全避免关联关系错乱的问题。

具体步骤与代码实现 #

1. 读取表格数据并转为结构化对象 #

先把表格中的所有数据读出来，遍历整理成「记录名: 数据点数组」的结构，这样同一记录的所有数据会被归在一起，不用再处理A列的空单元格：

function getStructuredData(sheet) {
  const data = sheet.getDataRange().getValues();
  const records = {};
  let currentRecord = '';

  for (const row of data) {
    // 如果A列有值，更新当前记录名
    if (row[0].toString().trim() !== '') {
      currentRecord = row[0].toString().trim();
      // 初始化该记录的数据数组
      if (!records[currentRecord]) {
        records[currentRecord] = [];
      }
      // 把当前行的B、C列数据加入数组
      records[currentRecord].push([row[1], row[2]]);
    } else if (currentRecord) {
      // A列空但有当前记录，直接加入数据
      records[currentRecord].push([row[1], row[2]]);
    }
  }
  return records;
}

2. 处理新增记录 #

拿到结构化对象后，新增数据就很简单：

function addNewData(records, recordName, newDataPoint) {
  // 去除首尾空格避免匹配错误
  const name = recordName.toString().trim();
  if (records[name]) {
    // 记录已存在，追加数据点
    records[name].push(newDataPoint);
  } else {
    // 记录不存在，新建条目
    records[name] = [newDataPoint];
  }
}

3. 排序记录并写回表格 #

把记录名排序后，按要求的格式写回表格（A列仅首行有记录名，后续行空）：

function writeDataBack(sheet, records) {
  // 清空原有数据（保留表头的话可以调整起始行）
  sheet.clearContents();
  let currentRow = 1;

  // 按记录名排序（可自定义排序规则）
  const sortedRecordNames = Object.keys(records).sort();

  for (const name of sortedRecordNames) {
    const dataPoints = records[name];
    // 写入第一条数据：A列填记录名，B、C列填数据
    sheet.getRange(currentRow, 1, 1, 3).setValues([[name, ...dataPoints[0]]]);
    currentRow++;
    // 写入后续数据：A列空，B、C列填数据
    if (dataPoints.length > 1) {
      const remainingRows = dataPoints.slice(1).map(point => ['', ...point]);
      sheet.getRange(currentRow, 1, remainingRows.length, 3).setValues(remainingRows);
      currentRow += remainingRows.length;
    }
  }
}

4. 整合调用示例 #

把上面的函数整合起来，实现完整的新增+排序流程：

function processNewRecord() {
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  const sheet = ss.getSheetByName('目标工作表'); // 替换成你的工作表名
  const newRecordName = '新记录名'; // 替换成要新增的记录名
  const newData = ['数据B', '数据C']; // 替换成要新增的B、C列数据

  // 读取并结构化数据
  const records = getStructuredData(sheet);
  // 新增数据
  addNewData(records, newRecordName, newData);
  // 排序后写回
  writeDataBack(sheet, records);
}

为什么这个方案更优 #

• 性能更好：仅需两次完整遍历（读一次，写一次），避免了多次统计空单元格的重复操作
• 鲁棒性强：不管用户如何手动编辑表格，每次处理都会重新整理数据结构，不会因为乱序或新增行导致关联关系出错
• 逻辑清晰：结构化后的数据更容易维护，后续要修改排序规则、新增列都只需调整少量代码

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