Google Sheets脚本开发：遍历选中单元格并为选中行末列添加文本

你想要实现的是遍历Google Sheets中选中的单元格，为所有选中行的最后一列添加文本，先看看你提供的代码片段里存在的几个小问题：

• 缺少ss变量的定义（没获取当前电子表格实例）
• 变量声明不规范，部分变量没加var/let/const，还缺了分号
• 只处理了每个选中范围的第一行，没覆盖范围内的所有行
• 拼接链接时email变量拼写错误（写成了emai...）
• 多次调用getRange会拖慢脚本速度，因为每次调用都要和Google服务器交互

基础版解决方案（易读易懂） #

这个版本逻辑清晰，适合新手理解，能满足基本需求：

function addTextToLastColumnOfSelectedRows() {
  // 获取当前电子表格和活动工作表
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  const sh = ss.getActiveSheet();
  const lastCol = sh.getLastColumn();
  const targetCol = lastCol + 1; // 要写入的列是最后一列的下一列

  // 获取所有选中的单元格范围
  const selectedRangeList = ss.getActiveRangeList();
  const ranges = selectedRangeList.getRanges();

  // 遍历每个选中的范围
  ranges.forEach(range => {
    const startRow = range.getRow();
    const numRows = range.getNumRows();

    // 处理当前范围内的每一行
    for (let row = startRow; row < startRow + numRows; row++) {
      // 获取当前行的姓名和邮箱数据
      const firstName = sh.getRange(row, 2).getValue();
      const lastName = sh.getRange(row, 3).getValue();
      const email = sh.getRange(row, 8).getValue();

      // 构建带参数的链接，用encodeURIComponent处理特殊字符
      const link = `http://192.168.80.1/d/?email=${encodeURIComponent(email)}&firstname=${encodeURIComponent(firstName)}&lastname=${encodeURIComponent(lastName)}`;

      // 将链接写入目标列
      sh.getRange(row, targetCol).setValue(link);
    }
  });
}

进阶优化版（性能更优） #

如果需要处理大量行，这个版本通过批量读写数据减少服务器交互次数，运行速度会快很多：

function addTextToLastColumnOfSelectedRowsOptimized() {
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  const sh = ss.getActiveSheet();
  const lastCol = sh.getLastColumn();
  const targetCol = lastCol + 1;
  const selectedRangeList = ss.getActiveRangeList();
  const ranges = selectedRangeList.getRanges();

  // 收集所有需要处理的行号，用Set避免重复处理同一行（比如选中范围重叠时）
  const rowsToProcess = new Set();
  ranges.forEach(range => {
    const startRow = range.getRow();
    const numRows = range.getNumRows();
    for (let row = startRow; row < startRow + numRows; row++) {
      rowsToProcess.add(row);
    }
  });

  // 把Set转成数组并按行号排序（可选，保证按从上到下的顺序处理）
  const sortedRows = Array.from(rowsToProcess).sort((a, b) => a - b);

  // 批量获取第2、3、8列的所有数据，只调用一次服务器接口
  const dataRange = sh.getRange(1, 2, sh.getLastRow(), 7); // 从第2列到第8列，共7列
  const allData = dataRange.getValues();

  // 准备要写入的数据数组
  const outputData = [];
  sortedRows.forEach(row => {
    const rowIndex = row - 1; // 数组索引从0开始，行号从1开始
    const firstName = allData[rowIndex][0]; // 第2列对应数组索引0
    const lastName = allData[rowIndex][1]; // 第3列对应数组索引1
    const email = allData[rowIndex][6]; // 第8列对应数组索引6
    const link = `http://192.168.80.1/d/?email=${encodeURIComponent(email)}&firstname=${encodeURIComponent(firstName)}&lastname=${encodeURIComponent(lastName)}`;
    outputData[rowIndex] = [link];
  });

  // 批量写入数据，只调用一次服务器接口
  sh.getRange(1, targetCol, sh.getLastRow(), 1).setValues(outputData.map(row => row || ['']));
}

使用方法 #

1. 打开你的Google Sheets表格
2. 点击顶部菜单栏的「扩展程序」→「Apps 脚本」
3. 将上面的代码粘贴到脚本编辑器中，保存并命名项目
4. 返回表格，选中需要处理的单元格或行
5. 点击「扩展程序」→ 你的项目名称 → 运行脚本（首次运行需要授权，按照提示操作即可）

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