Google Apps Script setValues报错与offsetval1长度异常问题咨询

报错根因说明 #

• 日志打印offsetval1.length返回1.0的核心原因：值采集逻辑存在覆盖赋值错误。未在循环外将offsetval1初始化为空数组，循环过程中每次直接将单格取值的二维数组（即单元格.offset(0,4).getValues()返回的[[值]]结构）覆盖赋值给offsetval1，最终变量仅留存最后1个匹配项对应的单格二维数组，数组长度自然为1，和实际9行的匹配规模完全脱节。
• setValues写入报错的核心原因：Apps Script的setValues方法对入参结构有严格要求，必须传入二维数组，且数组的行、列数量需要和调用方法的目标范围完全匹配。如果当前offsetval1仅为1行的二维数组，强行写入9行1列的K131:K139范围，就会直接触发“数据行数与目标范围行数不匹配”的报错。

符合要求的实现步骤 #

• 初始化存储结构：循环开始前定义空数组let offsetval1 = []，作为所有匹配值的统一存储容器，从根源上避免循环覆盖赋值的问题。
• 批量采集匹配值：
  1. 通过TextFinder获取指定范围内所有含"Requested"的单元格集合：const matchedRangeList = range.createTextFinder("Requested").findAll()
  2. 遍历每个匹配单元格，偏移4列取H列对应值时，逐行封装为符合二维数组要求的结构存入外层容器：

     matchedRangeList.getRanges().forEach(matchedCell => {
       // 偏移4列取H列的值，按单行列结构存入外层数组
       const hCellValue = matchedCell.offset(0, 4).getValue()
       offsetval1.push([hCellValue])
     })
     

  3. 完成采集后校验offsetval1.length，此时返回值会和实际匹配到的行数（9行）完全一致，结构为9行1列的标准二维数组。
• 动态范围写入：不要写死K131:K139的固定范围，以目标起始单元格K131为基准，根据实际采集到的数组长度动态匹配写入范围，彻底规避长度不匹配的问题：

  const sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet()
  const writeStartCell = sheet.getRange("K131")
  // 根据采集值的实际长度动态扩展写入范围
  writeStartCell.offset(0, 0, offsetval1.length, 1).setValues(offsetval1)
  

避坑提示 #

• 严格遵循二维数组入参要求：哪怕目标范围是单列，每一行的取值也要作为独立子数组存入外层数组，不能直接把单值push到外层形成一维数组，否则同样会触发结构不匹配的报错。
• 杜绝写死固定写入范围：如果实际匹配的"Requested"行数存在临时波动，写死固定9行的范围必然会触发长度不匹配的报错，动态匹配范围长度的实现稳定性更高。
• 避免循环内逐行写入：等所有匹配值采集完成后一次性批量写入，可大幅降低脚本的执行耗时，减少服务端配额消耗。

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