使用Google Apps Script复制数据时保留超链接的问题

问题根源 #

你触发的setRichTextValues异常，本质是源数据的富文本数组维度与目标单元格范围的行列数不匹配——比如源数据是3行5列，你却给目标指定了3行4列的范围，就会抛出这个错误。另外普通的setValues或copyValuesToRange只会复制纯文本，不会保留超链接这类富文本格式。

正确实现代码 #

function copyDataWithHyperlinks() {
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  const sourceSheet = ss.getSheetByName("week 1");
  const targetSheet = ss.getSheetByName("week 2");
  
  // 获取源表所有有数据的区域（自动匹配行列数）
  const sourceRange = sourceSheet.getDataRange();
  const richTextData = sourceRange.getRichTextValues();
  
  // 清空目标表原有内容（可选，按需调整）
  targetSheet.clearContents();
  
  // 目标范围必须和源数据的行列数完全一致
  const targetRange = targetSheet.getRange(1, 1, richTextData.length, richTextData[0].length);
  targetRange.setRichTextValues(richTextData);
}

核心注意点 #

• 强制保证目标范围的行数、列数和richTextData的维度严格对应：richTextData.length是行数，richTextData[0].length是列数（如果源表可能为空，要加判断避免数组越界）。
• 若只需复制特定区域（比如A2:D10），直接指定源范围为sourceSheet.getRange("A2:D10")，目标范围对应targetSheet.getRange("A2:D10")即可，无需手动计算行列。
• 绝对不要手动指定错误的目标范围，这是触发该异常的最常见原因。

简化替代方案（仅需保留超链接） #

如果源表只有超链接、无其他富文本格式（如加粗、颜色），可以直接复制公式（超链接通常由=HYPERLINK()公式实现）：

function copyHyperlinksQuickly() {
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  const sourceSheet = ss.getSheetByName("week 1");
  const targetSheet = ss.getSheetByName("week 2");
  
  const sourceRange = sourceSheet.getDataRange();
  // 复制公式保留超链接
  targetSheet.getRange(1,1,sourceRange.getNumRows(), sourceRange.getNumColumns()).setFormulas(sourceRange.getFormulas());
  // 同步复制值，避免公式失效时显示异常
  targetSheet.getRange(1,1,sourceRange.getNumRows(), sourceRange.getNumColumns()).setValues(sourceRange.getValues());
}

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