Google App Script基于两列拼接值跨表VLOOKUP及报错修复

• 二维数组行列不统一：匹配成功时返回长度为2的数组（Name、City两个值），匹配失败时仅返回长度为1的[null]，导致待写入数据的列数前后不一致，而setValues方法要求待写入的二维数组所有行的列数必须和目标写入区域的列数完全相等，因此反复抛出列数不匹配错误。
• 写入起始列错误：目标表待填充的Name、City列是第3、4列（C、D列），原代码从第2列（B列，Type列）开始写入，会覆盖原有Type列的有效数据。
• 缺少边界判断：当表格仅存在表头行时，getLastRow() -1计算结果为0，会触发范围参数非法错误。
• 匹配逻辑效率低：逐行遍历源表做find匹配，数据量较大时执行速度极慢。

function crossSheetVlookup() {
  // 获取目标表（当前活动表格的Sheet1）
  const targetSheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Sheet1");
  const targetLastRow = targetSheet.getLastRow();
  // 无有效数据行时直接终止
  if (targetLastRow < 2) return;
  // 读取目标表A、B列（Number、Type）的有效数据
  const targetData = targetSheet.getRange(2, 1, targetLastRow - 1, 2).getValues();

  // 获取源表（替换为你自己的源表ID、源表工作表名称）
  const sourceSheet = SpreadsheetApp.openById("替换为你的源Spreadsheet ID").getSheetByName("替换为源表的工作表名");
  const sourceLastRow = sourceSheet.getLastRow();
  if (sourceLastRow < 2) return;
  // 读取源表全量有效数据
  const sourceData = sourceSheet.getRange(2, 1, sourceLastRow - 1, 4).getValues();

  // 将源表转换为ID为键的映射表，大幅提升匹配效率
  const sourceMap = {};
  sourceData.forEach(row => {
    const idKey = row[0].toString();
    sourceMap[idKey] = [row[2], row[3]]; // 存储对应Name、City值
  });

  // 生成待写入的结果数组，固定每行2列，避免列数不匹配
  const writeData = targetData.map(row => {
    const matchKey = row[0].toString() + row[1].toString();
    // 匹配成功返回对应Name、City，匹配失败返回两个空值，固定列数为2
    return sourceMap[matchKey] ? sourceMap[matchKey] : [null, null];
  });

  // 从第2行、第3列（C列，Name列）开始写入，固定写入2列
  targetSheet.getRange(2, 3, writeData.length, 2).setValues(writeData);
}

• 匹配前先将源表数据转换为键值对映射，避免逐行遍历全量源数据，执行效率比原find逻辑高10~100倍，适配千行以上的动态数据场景。
• 待写入数组所有行固定为2列，完全匹配Name、City两列的写入要求，从根源解决列数不匹配报错。
• 写入位置精准对应C、D两列，不会误覆盖Number、Type列的原有数据。
• 增加空数据边界判断，无有效行时自动终止执行，不会触发范围参数错误。
• 所有拼接键统一转为字符串格式，避免数字、文本格式不一致导致的匹配失败问题。

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