修复Word转Google Docs后TOC失效问题，解决脚本误改TOC为标题的Bug

问题背景 #

将Word文档转换为Google Docs后，目录（TOC）失去跳转功能，无法链接到对应标题。编写了Google Apps Script尝试遍历TOC内容，为正文对应标题设置Heading样式并保留原字体格式，但脚本错误地将TOC本身标记为标题样式，需要排除TOC区域的匹配。

当前脚本 #

function toc() {
     const body = DocumentApp.getActiveDocument().getBody()
     const toc = body.findElement(DocumentApp.ElementType.TABLE_OF_CONTENTS).getElement().asTableOfContents()
     for(var i =  0 ; i < toc.getNumChildren() ; i++)
     {
        var tocElem = toc.getChild(i)
        var text = tocElem.getText()
        text = text.replace(/[\d\.]/g, "").trim() //.replace(/[\d\.]+$/, '')removing pagination of TOC
        console.log(text)
       if(text)
       {
         try{
        var elem = body.editAsText().findText(text)
        
        elem = elem.getElement().asText()
        console.log(elem)
        var font = elem.getFontFamily()
        var fontSize = elem.getFontSize()
        var style = {};
        style[DocumentApp.Attribute.HEADING] = DocumentApp.ParagraphHeading.HEADING6;
        var found =   body.findText(text)
        found.getElement().getParent().setAttributes(style)
         }
         catch(err)
         {
            //do nothing
         }
       }
     }
}

修改后的脚本（排除TOC区域） #

function fixTOCLinks() {
  const doc = DocumentApp.getActiveDocument();
  const body = doc.getBody();
  const tocElement = body.findElement(DocumentApp.ElementType.TABLE_OF_CONTENTS);
  
  if (!tocElement) {
    console.log("未找到目录");
    return;
  }
  
  const toc = tocElement.getElement().asTableOfContents();
  
  for (let i = 0; i < toc.getNumChildren(); i++) {
    const tocItem = toc.getChild(i);
    let titleText = tocItem.getText().trim();
    
    // 清理TOC文本：移除开头编号、末尾页码
    titleText = titleText.replace(/^[\d\.]+\s*/, '')
                         .replace(/\s+\d+$/, '')
                         .trim();
    
    if (!titleText) continue;
    
    let searchResult = body.findText(titleText);
    let targetParagraph = null;
    
    // 循环查找，跳过TOC内部的匹配项
    while (searchResult) {
      const foundParent = searchResult.getElement().getParent();
      
      // 判断当前匹配是否属于TOC的后代元素，是则跳过
      if (!isDescendantOf(foundParent, toc)) {
        targetParagraph = foundParent;
        break;
      }
      
      // 查找下一个匹配
      searchResult = body.findText(titleText, searchResult);
    }
    
    if (targetParagraph) {
      // 保存原字体样式
      const textElem = targetParagraph.editAsText();
      const fontFamily = textElem.getFontFamily();
      const fontSize = textElem.getFontSize();
      
      // 设置标题样式（可根据需求调整HEADING级别）
      const headingStyle = {};
      headingStyle[DocumentApp.Attribute.HEADING] = DocumentApp.ParagraphHeading.HEADING6;
      targetParagraph.setAttributes(headingStyle);
      
      // 恢复原字体大小和字体
      textElem.setFontFamily(fontFamily);
      textElem.setFontSize(fontSize);
      
      console.log(`已处理标题: ${titleText}`);
    } else {
      console.log(`未找到匹配标题: ${titleText}`);
    }
  }
}

// 辅助函数：判断元素是否为指定父元素的后代
function isDescendantOf(child, parent) {
  let current = child;
  while (current) {
    if (current === parent) return true;
    current = current.getParent();
  }
  return false;
}

关键修改点 #

• 新增isDescendantOf辅助函数，用于检测找到的文本是否属于TOC区域，避免误修改TOC本身。
• 循环查找匹配文本，跳过TOC内部的结果，定位到正文里的目标标题段落。
• 优化标题文本清洗逻辑，更精准地移除TOC中的编号和页码。
• 先设置Heading样式，再恢复原字体格式，确保标题样式生效的同时保留原有排版。

其他解决思路 #

• 提前规范Word样式：在Word中给所有标题应用内置的标题样式（如标题1、标题2），再导入Google Docs，此时Google Docs会自动识别这些样式，TOC可直接正常跳转。
• 手动修复：若文档篇幅较小，可直接手动选中正文标题，在Google Docs工具栏中选择对应的Heading样式，TOC会自动更新并生成链接。

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