Google Sheets脚本问题：getRange().setValue(sampleArray)仅复制首单元格值

嘿，我之前跟着教程练的时候也踩过这个一模一样的坑！咱们来拆解下问题：

问题根源 #

你肯定是用了setValue()而不是setValues()！
setValue()是给单个单元格赋值的方法，当你把它用在一片单元格区域上时，它会把传入的单个值（这里就是A1的内容）重复填充到区域里的每一格。而setValues()才是Google Apps Script里专门用来把二维数组对应填充到单元格区域的方法，正好匹配你已经用Logger.log确认过的nameRange数组。

修复步骤 #

1. 先确认你的nameRange是二维数组（Google Sheets对setValues()的要求很严格，哪怕是单列数据，也得是嵌套的二维结构，比如[["Alice"], ["Bob"], ["Charlie"]]，不能是一维的["Alice", "Bob", "Charlie"]）
2. 把代码里的setValue(nameRange)直接改成setValues(nameRange)就行

代码示例对比 #

错误写法（导致重复值）：

// 错误：用setValue给区域赋值，会把单个值铺满整个区域
const targetSheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
const targetRange = targetSheet.getRange("B1:B5");
targetRange.setValue(nameRange);

正确写法（匹配数组填充）：

// 正确：用setValues把数组对应填充到区域
const targetSheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
const targetRange = targetSheet.getRange("B1:B5");
// 如果nameRange是一维数组，先转成二维：const formattedRange = nameRange.map(item => [item]);
targetRange.setValues(nameRange);

额外小提醒 #

如果你的nameRange是手动构建的一维数组，记得用nameRange.map(item => [item])把它转换成二维数组，这样setValues()才能正确识别每一行对应一个单元格。

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