GAS中二维数组写入Google Sheets单列报错：行数不匹配

问题描述 #

在Google Apps Script中，已将数据填充到二维数组，尝试将数组数据写入Google Sheets单列时，持续报错提示数据行数与范围行数不匹配，代码如下：

var allExpensesStatus = [];
for (i = 0; i < somevar.length; i++)
{
   allExpensesStatus.push([i,"some text"]);
}

spreadsheet.getSheetByName("MySheet").getRange("H2:H" + allExpensesStatus.length).setValues(allExpensesStatus);

错误原因 #

1. 列数不匹配：你创建的allExpensesStatus是每行包含2个元素的二维数组（例如[[0,"some text"], [1,"some text"], ...]），但目标范围是单列（H列），列数为1，setValues要求数组的行列数必须和选中范围完全一致，列数不匹配直接触发报错。
2. 行数计算错误：目标范围用H2:H" + allExpensesStatus.length的写法存在偏差——比如数组长度是3，范围会变成H2:H3，实际只有2行，而数组有3行，行数也不匹配。

修复方案 #

方案1：调整数组为单列结构（仅写入单列数据） #

如果只需要将其中一列数据写入H列，修改数组的push逻辑，每行只保留一个元素：

var allExpensesStatus = [];
for (i = 0; i < somevar.length; i++)
{
   // 按需选择要写入的元素，比如索引i或者文本内容
   allExpensesStatus.push([i]); 
   // 或者 allExpensesStatus.push(["some text"]);
}
var sheet = spreadsheet.getSheetByName("MySheet");
// 精准指定范围：第2行第8列（H列）开始，共数组长度行，1列
sheet.getRange(2, 8, allExpensesStatus.length, 1).setValues(allExpensesStatus);

方案2：调整目标范围为多列（保留数组两列数据） #

如果原本就想把数组的两列数据写入表格，修改范围为多列（比如H、I列），同时修正行数计算：

var allExpensesStatus = [];
for (i = 0; i < somevar.length; i++)
{
   allExpensesStatus.push([i,"some text"]);
}
var sheet = spreadsheet.getSheetByName("MySheet");
// 范围从H2开始，行数为数组长度，列数为2
sheet.getRange(2, 8, allExpensesStatus.length, 2).setValues(allExpensesStatus);

关键注意事项 #

• 优先使用getRange(row, column, numRows, numColumns)方法，相比A1符号写法更精准，能避免行列数计算错误。
• setValues对数组和范围的行列数要求严格一致，必须完全匹配才能成功写入。

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