如何在Google工作表间迁移数据并保留超链接

问题背景 #

我有两个独立的Google工作表，需将源工作表数据迁移到目标工作表。此前使用以下代码可完成迁移：

function dataImport2() {
 //@NotOnlyCurrentDoc
var values = SpreadsheetApp.openById('id').
getSheetByName('All').getRange('c1:m').getValues();
SpreadsheetApp.getActive().getSheetByName('All').
getRange(1,1,values.length,values[0].length).setValues(values);
}

但本次迁移的源数据包含字符串、数值及带超链接的内容，上述代码无法保留单元格超链接。尝试用getRichTextValues编写的代码未能解决问题：

function dataImport() {
  var sourceSheet = SpreadsheetApp.openById('id').getSheetByName('All');
  var destinationSheet = SpreadsheetApp.getActive().getSheetByName('All');
  var range = sourceSheet.getRange('C1:M');
  var formulas = range.getFormulas();
  var richTextValues = range.getRichTextValues();
  
  for (var i = 0; i < formulas.length; i++) {
    for (var j = 0; j < formulas[0].length; j++) {
      var formula = formulas[i][j];
      var linkUrl = formula.match(/&quot;(.*?)&quot;/);
      if (linkUrl !== null) {
        var richTextValue = richTextValues[i][j];
        richTextValue.setLinkUrl(linkUrl[1]);
        destinationSheet.getRange(i+1, j+1).setRichTextValue(richTextValue);
      } else {
        destinationSheet.getRange(i+1, j+1).setValue(formulas[i][j]);
      }
    }
  }
}

解决方案 #

直接利用getRichTextValues()和setRichTextValues()批量操作，无需单独解析公式或链接，富文本值已包含所有格式信息：

function dataImportWithLinks() {
  //@NotOnlyCurrentDoc
  const sourceId = '替换为源工作表ID';
  const sourceSheet = SpreadsheetApp.openById(sourceId).getSheetByName('All');
  const destSheet = SpreadsheetApp.getActive().getSheetByName('All');
  
  // 获取源数据范围（C1:M）的富文本值
  const sourceRange = sourceSheet.getRange('C1:M');
  const richTextValues = sourceRange.getRichTextValues();
  
  // 清除目标表对应区域旧数据（可选，根据需求调整）
  destSheet.getRange(1, 1, richTextValues.length, richTextValues[0].length).clearContent();
  
  // 批量写入富文本值，保留所有格式（含超链接）
  destSheet.getRange(1, 1, richTextValues.length, richTextValues[0].length).setRichTextValues(richTextValues);
}

说明 #

• 该方法完整复制单元格的所有富文本格式，包括超链接、字体样式、颜色等
• 批量读写比循环逐个操作效率更高，适合处理大量数据
• 需将代码中的'替换为源工作表ID'替换为实际的源工作表ID
• 若目标表需要保留原有格式，可移除clearContent()行

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