Google Apps Script报错：起始行范围过小，跨表匹配赋值功能失效

算力阿峰

2026-8-11

问题解决：Google Apps Script 行号错误及优化方案

错误原因

你代码里用for (n in data1_values)遍历数组时，得到的n是从0开始的数组索引，但Google Sheets的行号是从1开始计数的。当n=0时，执行sheet1.getRange(n,13)会传入行号0，直接触发The starting row of the range is too small错误。

修复步骤

1. 直接修正行号问题

把行号改为Number(n)+1，因为数组索引比实际行号小1（data1_values[0]对应Sheet1的第1行）：

var durationsclass = sheet1.getRange(Number(n)+1,13);

2. 高效优化方案（推荐）

原代码用嵌套循环+多次setValue，数据量大时会非常慢，还容易触发Google服务调用次数限制。建议改用批量读取+映射匹配+批量写入的方式：

function labelRows() {
  const spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
  const sheet1 = spreadsheet.getSheetByName("Sheet1");
  const sheet2 = spreadsheet.getSheetByName("Sheet2");
  
  // 读取两张表的全部数据
  const data1 = sheet1.getDataRange().getValues();
  const data2 = sheet2.getDataRange().getValues();
  
  // 把Sheet2的匹配规则存进Map：前3列拼接成唯一键，对应第4列的值
  const durationMap = new Map();
  data2.forEach(row => {
    const key = `${row[0]}|${row[1]}|${row[2]}`;
    durationMap.set(key, row[3]);
  });
  
  // 遍历Sheet1数据，匹配后填充第13列（数组索引为12）
  const updatedData = data1.map(row => {
    const key = `${row[0]}|${row[1]}|${row[2]}`;
    // 找到匹配项就替换，没找到则保留原内容
    row[12] = durationMap.get(key) || row[12];
    return row;
  });
  
  // 一次性把更新后的数据写回Sheet1
  sheet1.getRange(1, 1, updatedData.length, updatedData[0].length).setValues(updatedData);
}