如何基于变量定位目标范围并完成表格匹配数据的写入更新

以下是可直接复用的代码模板，核心逻辑是通过批量匹配唯一标识列得到目标行号，再执行读写操作：

function updateMainTable() {
  // 配置参数：按需修改表名、列范围即可
  const CONFIG = {
    searchValueCell: 'B1', // 存储目标姓名的单元格位置
    sheet1Name: '表1',
    sheet2Name: '表2',
    dataStartRow: 2, // 假设表头占1行，实际数据从第2行开始，按需调整
    totalColumns: 5 // 表格总列数，按需修改为你实际的列数
  }

  const ss = SpreadsheetApp.getActiveSpreadsheet()
  // 1. 获取要搜索的目标姓名
  const targetName = ss.getRange(CONFIG.searchValueCell).getValue().trim()
  if (!targetName) return // 搜索值为空直接退出

  // 2. 分别获取两个表的A列（唯一标识列）所有数据
  const sheet1 = ss.getSheetByName(CONFIG.sheet1Name)
  const sheet1Names = sheet1.getRange(CONFIG.dataStartRow, 1, sheet1.getLastRow() - CONFIG.dataStartRow + 1, 1).getValues().flat()
  const sheet2 = ss.getSheetByName(CONFIG.sheet2Name)
  const sheet2Names = sheet2.getRange(CONFIG.dataStartRow, 1, sheet2.getLastRow() - CONFIG.dataStartRow + 1, 1).getValues().flat()

  // 3. 匹配得到目标行号：数组下标从0开始，所以要加数据起始行的偏移
  const sheet1TargetRowIndex = sheet1Names.findIndex(name => name.trim() === targetName)
  if (sheet1TargetRowIndex === -1) throw new Error('表1中未找到匹配的姓名')
  const sheet1TargetRow = sheet1TargetRowIndex + CONFIG.dataStartRow

  const sheet2TargetRowIndex = sheet2Names.findIndex(name => name.trim() === targetName)
  if (sheet2TargetRowIndex === -1) throw new Error('表2中未找到匹配的姓名')
  const sheet2TargetRow = sheet2TargetRowIndex + CONFIG.dataStartRow

  // 4. 读取表1对应行数据，写入表2
  const updateValues = sheet1.getRange(sheet1TargetRow, 1, 1, CONFIG.totalColumns).getValues()
  sheet2.getRange(sheet2TargetRow, 1, 1, CONFIG.totalColumns).setValues(updateValues)
}

关键逻辑说明 #

• 没有逐行遍历匹配，而是一次性读取整列数据做批量匹配，性能远高于逐行读取
• 加了trim()处理姓名前后空格的问题，避免因为隐形空格匹配失败
• 所有可变参数都放到了CONFIG对象里，修改适配你的表格不需要动核心逻辑
• 内置了空值、匹配不到的异常判断，避免运行报错

注意事项 #

如果你的表格没有表头，直接把CONFIG里的dataStartRow改成1即可；如果需要更新的列不是整行，修改totalColumns或者调整读写范围的列参数即可。

内容的提问来源于stack exchange，提问作者d-ron