Google Sheets脚本问题：提取超链接引用文本至新表格失败

问题核心 #

你遇到的超链接是通过「插入链接」功能添加的（非=HYPERLINK()公式），这类链接的目标地址存储在单元格的富文本属性中，普通脚本无法直接读取，需要解析richTextValue来提取目标区域引用。

完整脚本代码 #

function extractLinkedText() {
  // 替换为你的源工作表名称
  const sourceSheetName = "源工作表";
  // 替换为超链接所在的行号（比如第3行写3）
  const hyperlinkRow = 2;
  // 新工作表名称（如果不存在会自动创建）
  const targetSheetName = "提取结果";

  const ss = SpreadsheetApp.getActiveSpreadsheet();
  const sourceSheet = ss.getSheetByName(sourceSheetName);
  if (!sourceSheet) {
    SpreadsheetApp.getUi().alert("找不到指定的源工作表！");
    return;
  }

  // 获取目标工作表，不存在则创建
  let targetSheet = ss.getSheetByName(targetSheetName);
  if (!targetSheet) {
    targetSheet = ss.insertSheet(targetSheetName);
  }
  // 清空目标工作表原有内容（可选，根据需求调整）
  targetSheet.clearContents();

  // 获取源工作表中超链接所在行的所有单元格
  const rowRange = sourceSheet.getRange(hyperlinkRow, 1, 1, sourceSheet.getLastColumn());
  const cells = rowRange.getRichTextValues()[0];

  let extractedTexts = [];

  cells.forEach((cell, index) => {
    // 检查单元格是否有富文本链接
    const links = cell.getLinks();
    if (links.length > 0) {
      const url = links[0].getUrl();
      // 解析Google Sheets内部链接的区域引用格式
      // 格式通常为：#gid=工作表ID&range=区域引用，或者直接是区域引用（如'SheetName'!A1:A5）
      let rangeRef;
      if (url.includes('#gid=')) {
        // 处理带gid的链接格式
        const rangeParam = url.split('range=')[1];
        if (rangeParam) {
          rangeRef = decodeURIComponent(rangeParam);
        }
      } else {
        // 处理直接的区域引用格式（如'SheetName'!A16:A24）
        rangeRef = url;
      }

      if (rangeRef) {
        try {
          // 获取引用区域的文本内容
          const targetRange = ss.getRange(rangeRef);
          const rangeValues = targetRange.getDisplayValues();
          // 将区域文本合并为单行（如果是多行区域，可改为换行分隔：rangeValues.flat().join('\n')）
          const combinedText = rangeValues.flat().join(' ');
          extractedTexts.push([combinedText]);
        } catch (e) {
          // 处理无效引用或权限问题
          extractedTexts.push([`解析失败：${e.message}`]);
        }
      } else {
        extractedTexts.push(["无法识别链接目标"]);
      }
    } else {
      // 单元格无超链接时留空或标记
      extractedTexts.push(["无超链接"]);
    }
  });

  // 将提取的文本写入目标工作表的第一列
  if (extractedTexts.length > 0) {
    targetSheet.getRange(1, 1, extractedTexts.length, 1).setValues(extractedTexts);
    SpreadsheetApp.getUi().alert("提取完成，结果已写入" + targetSheetName + "工作表！");
  }
}

使用步骤 #

1. 打开你的Google Sheets文档，点击顶部菜单栏「扩展程序」→「Apps脚本」，打开脚本编辑器。
2. 删除编辑器里的默认代码，粘贴上面的脚本。
3. 修改脚本开头的三个常量：
   • sourceSheetName：替换为包含超链接的工作表名称
   • hyperlinkRow：替换为超链接所在的行号（比如超链接在第2行就写2）
   • targetSheetName：替换为存储结果的新工作表名称（不存在会自动创建）
4. 点击编辑器顶部的「运行」按钮，首次运行会要求授权，按照提示完成授权即可。

关键逻辑说明 #

• 解析富文本链接：通过getRichTextValues()获取单元格的富文本属性，再用getLinks()提取链接地址。
• 适配两种内部链接格式：Google Sheets的内部链接有两种形式，一种是带#gid=的URL格式，一种是直接的区域引用格式，脚本会自动识别并解析。
• 处理区域文本：将引用区域的所有文本合并为单行（如果需要保留换行，可修改join(' ')为join('\n')）。

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