如何用Google Apps Script按唯一姓名提取工作表行并输出至活动表？

原代码的核心问题 #

1. getActiveCell 缺少调用括号，应为 outSheet.getActiveCell()，且直接赋值变量无法修改表格内容，需用工作表写入方法
2. 无需遍历所有列查找姓名：H列对应数组索引为7（A列为0），直接定位range[i][7]即可
3. inputSheet.getRange[i] 语法错误，方法调用需加括号；且已通过getDataRange().getValues()获取全量数据，直接从数组取行更高效
4. 未正确将匹配行写入输出工作表，仅赋值变量不会修改表格
5. 未实现提取唯一姓名对应行的需求，仅查找固定单个姓名

修复版：提取单个指定人员数据 #

function extractSinglePersonData() {
  const mainSpreadSheet = SpreadsheetApp.getActiveSpreadsheet();
  const inputSheet = mainSpreadSheet.getSheetByName("Assets");
  const outSheet = mainSpreadSheet.getActiveSheet();
  const rangeValues = inputSheet.getDataRange().getValues();
  const targetName = "Joshua Butters";
  const outputRows = [];

  // 遍历行，匹配H列（索引7）的目标姓名
  for (let i = 0; i < rangeValues.length; i++) {
    if (rangeValues[i][7] === targetName) {
      outputRows.push(rangeValues[i]);
    }
  }

  // 批量写入匹配数据到活动单元格起始位置
  if (outputRows.length > 0) {
    const startCell = outSheet.getActiveCell();
    outSheet.getRange(
      startCell.getRow(), 
      startCell.getColumn(), 
      outputRows.length, 
      outputRows[0].length
    ).setValues(outputRows);
  } else {
    SpreadsheetApp.getUi().alert("未找到匹配的数据");
  }
}

完整版：提取所有唯一姓名的对应行数据 #

function extractUniquePersonsData() {
  const mainSpreadSheet = SpreadsheetApp.getActiveSpreadsheet();
  const inputSheet = mainSpreadSheet.getSheetByName("Assets");
  const outSheet = mainSpreadSheet.getActiveSheet();
  const rangeValues = inputSheet.getDataRange().getValues();
  const uniqueNames = new Set();
  const nameRowsMap = new Map();

  // 收集唯一姓名并映射对应行数据
  for (let i = 0; i < rangeValues.length; i++) {
    const name = rangeValues[i][7];
    if (!name) continue; // 跳过空姓名行
    uniqueNames.add(name);
    // 为姓名创建行数组（不存在则初始化）
    if (!nameRowsMap.has(name)) nameRowsMap.set(name, []);
    nameRowsMap.get(name).push(rangeValues[i]);
  }

  // 批量写入每个唯一姓名的数据
  let currentRow = outSheet.getActiveCell().getRow();
  const currentCol = outSheet.getActiveCell().getColumn();

  uniqueNames.forEach(name => {
    const rows = nameRowsMap.get(name);
    // 写入姓名标题（可选）
    outSheet.getRange(currentRow, currentCol).setValue(`=== ${name} 的设备数据 ===`);
    currentRow++;
    // 写入对应行数据
    outSheet.getRange(
      currentRow, 
      currentCol, 
      rows.length, 
      rows[0].length
    ).setValues(rows);
    currentRow += rows.length + 1; // 空行分隔不同人员数据
  });

  SpreadsheetApp.getUi().alert("数据提取完成");
}

关键优化说明 #

• 用Set快速去重姓名，Map存储姓名与行数据的映射，逻辑清晰高效
• 优先操作getValues()返回的二维数组，减少Google服务方法调用次数（脚本性能优化核心）
• 批量写入数据：一次setValues替代逐行写入，大幅提升执行速度
• 增加空值判断和弹窗提示，提升使用体验

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