Google Apps Script嵌套数组索引访问返回undefined及行数据复制问题

问题 #

在Google表格中处理行数据复制任务：将选中行的指定数据复制到空白行（不新增行），中间留空供手动输入数据。遇到以下问题：

• 无法单独访问嵌套数组元素，数组整体可正常打印，但直接取元素失败
• 使用getValue()仅能获取数组第一个元素
• 调用activeRow[0][0].getValue()抛出TypeError: Cannot read property 'getValue' of undefined错误

当前代码：

const sheet = SpreadsheetApp.getActiveSheet();
const activeCell = sheet.getCurrentCell();

function test() {
  let activeRow = sheet.getRangeList([activeCell.getA1Notation() + ':' + activeCell.offset(0,1).getA1Notation(), activeCell.offset(0,3).getA1Notation(), activeCell.offset(0,5).getA1Notation() + ':' + activeCell.offset(0,7).getA1Notation()]).getRanges();
  Logger.log(activeRow[0][0].getValue())
};

问题原因 #

getRangeList().getRanges()返回的是Range对象数组，并非二维值数组。每个activeRow[index]是一个Range对象，不是数组，因此不能用activeRow[0][0]的方式访问——这是错误地将Range对象当作二维数组处理，必然触发报错：

• activeRow[0].getValue()返回该Range的第一个单元格值，符合Range对象的方法特性
• activeRow[0].getValues()返回该Range对应的二维值数组，因此能获取行内多个单元格的数值

解决方案 #

1. 正确访问单个单元格值 #

要获取Range内的单个单元格值，需先通过getValues()拿到二维数组，再用索引访问：

const sheet = SpreadsheetApp.getActiveSheet();
const activeCell = sheet.getCurrentCell();

function test() {
  const rangeList = sheet.getRangeList([
    activeCell.getA1Notation() + ':' + activeCell.offset(0,1).getA1Notation(),
    activeCell.offset(0,3).getA1Notation(),
    activeCell.offset(0,5).getA1Notation() + ':' + activeCell.offset(0,7).getA1Notation()
  ]).getRanges();
  
  // 获取第一个Range的第一行第一列值
  const firstValue = rangeList[0].getValues()[0][0];
  Logger.log(firstValue);
  
  // 获取第三个Range的第一行第二列值
  const thirdRangeSecondCol = rangeList[2].getValues()[0][1];
  Logger.log(thirdRangeSecondCol);
};

2. 行数据复制的优化实现 #

针对你的复制需求，推荐批量读取/写入数据（减少API调用次数，符合Google Apps Script性能优化原则）：

const sheet = SpreadsheetApp.getActiveSheet();
const activeCell = sheet.getCurrentCell();
const sourceRowNum = activeCell.getRow();
// 目标空白行可根据需求自定义，此处默认当前行下一行
const targetRowNum = sourceRowNum + 1;

function copyRowData() {
  // 定义需要复制的源列范围（A-B、D、F-H）
  const sourceRanges = [
    sheet.getRange(sourceRowNum, 1, 1, 2),
    sheet.getRange(sourceRowNum, 4, 1, 1),
    sheet.getRange(sourceRowNum, 6, 1, 3)
  ];
  
  // 批量读取所有需要的值
  const sourceValues = sourceRanges.map(range => range.getValues()[0]);
  
  // 定义目标行的对应写入位置（留空C、E列）
  const targetRanges = [
    sheet.getRange(targetRowNum, 1, 1, 2),
    sheet.getRange(targetRowNum, 4, 1, 1),
    sheet.getRange(targetRowNum, 6, 1, 3)
  ];
  
  // 批量写入数据
  targetRanges.forEach((range, index) => {
    range.setValues([sourceValues[index]]);
  });
  
  Logger.log("数据复制完成");
}

3. 简洁版批量操作思路 #

如果留空列规则固定，可直接读取整行数据，筛选后写入目标行：

function copyRowDataSimplified() {
  // 读取源行所有数据
  const sourceRow = sheet.getRange(sourceRowNum, 1, 1, sheet.getLastColumn()).getValues()[0];
  // 复制整行并清空需要手动输入的列（示例：C列=索引2、E列=索引4）
  const targetRow = sourceRow.map((val, idx) => [2,4].includes(idx) ? "" : val);
  
  // 写入目标行
  sheet.getRange(targetRowNum, 1, 1, targetRow.length).setValues([targetRow]);
}

内容的提问来源于stack exchange，提问作者Mr.Turtle