Google Apps Script实现行内容合并至另一工作表并添加##note标记

function sendRowsToOtherTab(){  
  // 定义关联工作表
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var eddGenSheet = ss.getSheetByName("Eddie Input Generator");
  var comboPageSheet = ss.getSheetByName("Combo Page");

  // 读取源表有效数据范围
  var sourceLastRow = eddGenSheet.getLastRow();
  var sourceLastCol = eddGenSheet.getLastColumn();
  // 从A5开始计算有效数据行数
  var sourceDataRowCount = sourceLastRow - 4;
  // 边界判断：如果A5以上没有数据直接退出
  if (sourceDataRowCount <=0) {
    SpreadsheetApp.getUi().alert("Eddie Input Generator 表从A5开始没有可处理的数据");
    return;
  }
  // 一次性读取所有源数据到二维数组，减少服务器交互
  var sourceData = eddGenSheet.getRange(5, 1, sourceDataRowCount, sourceLastCol).getValues();

  // 准备目标表写入的内容数组
  var targetWriteContent = [];
  // 遍历每一行源数据做拼接
  sourceData.forEach(function(row){
    // 等效实现 TEXTJOIN(" ",1, 当前行)：过滤空值，用空格连接
    var joinedRowText = row.filter(cellValue => cellValue !== "").join(" ");
    // 匹配公式的 CONCAT(" ", 拼接结果) 效果，前置单个空格
    joinedRowText = " " + joinedRowText;

    // 组装两行写入内容：第一行是note标记，第二行是拼接文本
    targetWriteContent.push(["## note line"]);
    targetWriteContent.push([joinedRowText]);
  });

  // 从目标表B19位置开始一次性写入所有内容
  var insertStartCell = comboPageSheet.getRange("B19");
  // 计算写入范围的行数：每一行源数据占2行目标位置
  comboPageSheet.getRange(insertStartCell.getRow(), insertStartCell.getColumn(), targetWriteContent.length, 1).setValues(targetWriteContent);

  // 写入完成后清空源表处理过的范围
  eddGenSheet.getRange(5, 1, sourceDataRowCount, sourceLastCol).clearContent();
}

核心卡点的实现说明 #

等效Google Sheets公式的字符串拼接逻辑 #

• 你需要的公式效果是 CONCAT(" ",TEXTJOIN(" ",1,A5:5))，对应到JS实现不需要调用表格公式，直接用原生数组方法就能完成：
  • filter(cellValue => cellValue !== "") 对应公式里TEXTJOIN的1参数（忽略空单元格）
  • .join(" ") 对应把所有非空单元格用空格拼接的逻辑
  • 前置加一个空格就是匹配最外层CONCAT(" ", 拼接结果)的效果，和原公式输出完全一致
• 没有引入额外的复杂逻辑，每一步操作都是基础数组方法，新手也能看懂对应关系

逐行插入note标记的循环逻辑 #

• 不需要逐行操作目标表单元格写入，只需要在遍历源表每一行的时候，往准备好的写入数组里连续push两个元素：第一个是固定的## note line，第二个是拼接好的文本
• 等所有源行处理完，直接把整个组装好的二维数组一次性写到目标表的起始位置，自然就实现了“每段拼接文本上方紧跟一行note标记”的效果，比逐格写入快10倍以上，也不会漏行错行

新手容易踩的坑修正 #

• 原代码里写的getrange是错误写法，Apps Script是大小写敏感的，正确方法名是getRange，写错会直接报方法不存在的错误
• 原代码计算源表最后一行的时候多加了+1，会导致读到不存在的空行范围，修正为直接获取getLastRow()的真实值，避免无效操作
• 所有写入、读取操作都采用批量数组交互，不会因为逐格操作触发脚本执行超时的问题
• 清空源表时使用clearContent()而非clear()，只会清除单元格内容，不会误删原有格式

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