如何在Google Sheets中用setValue写入变量数组值并实现单元格清理？

一、正确实现跨工作表取值写入（兼容后续清理） #

你遇到的核心问题是混淆了「单元格值」和「单元格对象（Range）」的用法：setValue/setValues需要传入值的数组，而非单元格对象；而要执行clearContent这类单元格操作，必须操作Range对象。以下是修正后的Formulario函数实现：

function Formulario() {
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  const cadastroSheet = ss.getSheetByName('Cadastro2');
  const baseSheet = ss.getSheetByName('Base1');

  // 1. 定义需要读取的目标单元格（按你的实际需求调整单元格地址）
  const targetRanges = [
    cadastroSheet.getRange('A2'),
    cadastroSheet.getRange('C3'),
    cadastroSheet.getRange('E4'),
    cadastroSheet.getRange('G5')
  ];

  // 2. 从单元格对象中提取值，组装成setValues要求的二维数组格式
  const valuesToWrite = [targetRanges.map(range => range.getValue())];

  // 3. 将值写入Base1的下一行
  const nextRow = baseSheet.getLastRow() + 1;
  baseSheet.getRange(nextRow, 1, valuesToWrite.length, valuesToWrite[0].length).setValues(valuesToWrite);

  // 4. 直接执行清理（也可把targetRanges传递给单独的清理函数）
  targetRanges.forEach(range => range.clearContent());
}

关键说明： #

• setValues要求传入二维数组，比如[[值1, 值2, 值3]]对应一行三列，一维数组或单元格对象数组都会导致写入失败/空行。
• 提前存储Range对象，不管是写入后直接清理，还是传给单独的清理函数，都能正常调用clearContent()。

二、单独清理函数的正确写法 #

如果需要拆分清理逻辑，直接在函数中定义要操作的Range对象即可：

function LimparFormulario() {
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  const cadastroSheet = ss.getSheetByName('Cadastro2');

  // 定义需要清理的单元格范围（和写入时保持一致）
  const targetRanges = [
    cadastroSheet.getRange('A2'),
    cadastroSheet.getRange('C3'),
    cadastroSheet.getRange('E4'),
    cadastroSheet.getRange('G5')
  ];

  targetRanges.forEach(range => range.clearContent());
}

为什么之前的清理函数无效？ #

你之前的数组存储的是单元格的值（字符串/数字类型），而非Range对象。值本身没有clearContent()方法，自然无法执行清理操作，必须操作Range对象才能修改单元格内容。

三、批量操作优化（针对连续单元格） #

如果「Cadastro2」中需要读取的是连续单元格（比如A2:D2），可以用更高效的批量读写方式：

function FormularioBatch() {
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  const cadastroSheet = ss.getSheetByName('Cadastro2');
  const baseSheet = ss.getSheetByName('Base1');

  // 批量读取连续单元格的值
  const readRange = cadastroSheet.getRange('A2:D2');
  const values = readRange.getValues();

  // 批量写入到Base1
  baseSheet.getRange(baseSheet.getLastRow()+1, 1, values.length, values[0].length).setValues(values);

  // 批量清理
  readRange.clearContent();
}

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