SpreadsheetApp.Range.setValues参数不匹配错误解决求助

这个错误的核心原因是setValues()方法必须接收二维数组作为参数，而你通过循环push构建的是一维数组，导致参数类型不匹配。

关键规则：setValues的参数要求 #

setValues()的输入必须是「行数组包含列数组」的二维结构：

• 外层数组的每一个元素代表表格中的一行
• 内层数组的每一个元素代表该行对应的一列值
• 例如写入2行3列的数据，数组结构应为：[[A1,B1,C1], [A2,B2,C2]]

循环构建数组的正确姿势 #

如果你用循环逐行生成数据，每次push的必须是单行的数组，而非单个值。

错误示例（复现你的问题）

function wrongBuildArray() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const data = [];
  // 错误：直接push单个值，生成一维数组
  for (let i = 1; i <= 3; i++) {
    data.push(i); 
  }
  // 此时data是[1,2,3]，传入setValues会报错
  sheet.getRange(1, 1, data.length, 1).setValues(data);
}

修正后的代码

function correctBuildArray() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const data = [];
  // 正确：每次push包含单个值的数组，生成二维数组
  for (let i = 1; i <= 3; i++) {
    data.push([i]); 
  }
  // 此时data是[[1],[2],[3]]，符合setValues的参数要求
  sheet.getRange(1, 1, data.length, 1).setValues(data);
}

额外注意事项 #

1. 行列数匹配：调用getRange(startRow, startCol, numRows, numCols)时，numRows要等于二维数组的长度（行数），numCols要等于内层数组的长度（列数）。
2. 内层数组长度一致：所有行对应的内层数组长度必须相同，否则会抛出另一个参数不匹配的错误。

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