修改Google Apps Script实现Doc URL唯一ID写入页眉页脚

你之前尝试的页眉页脚写入写法有误，核心问题是混淆了Document、FooterSection等不同对象的可用方法，且没有处理新文档默认未初始化页眉/页脚时返回null的边界情况。下面是调整后可直接运行的完整脚本，保留原有全部功能的同时，实现ID双区域冗余存储的需求：

function onOpen(e) {
  DocumentApp.getUi().createMenu('NewDoc')
    .addItem('Create', 'newDocWithSentense')
    .addToUi();
}

function newDocWithSentense() {
  const currentDoc = DocumentApp.getActiveDocument();
  const cursor = currentDoc.getCursor();
  // 基础容错：避免光标位置不对时脚本报错
  if (!cursor || !cursor.getSurroundingText()) {
    DocumentApp.getUi().alert('请将光标放在要创建关联文档的名称文本上再运行');
    return;
  }
  const linkText = cursor.getSurroundingText().getText().trim();
  if (!linkText) {
    DocumentApp.getUi().alert('光标所在位置没有有效文档名称');
    return;
  }
  // 获取当前文档所属文件夹
  const currentFolder = DriveApp.getFileById(currentDoc.getId()).getParents().next();
  // 创建同名新文档
  const newDocFile = DocumentApp.create(linkText);
  const newDocId = newDocFile.getId();
  // 将新文档移动到当前文档所在文件夹
  DriveApp.getFileById(newDocId).moveTo(currentFolder);
  // 给当前文档光标所在文本添加指向新文档的超链接
  cursor.getSurroundingText().setLinkUrl(newDocFile.getUrl());

  // 写入ID到新文档页眉、页脚做冗余存储
  const docIdMark = `DocID:${newDocId}`;
  // 处理页眉：不存在则自动创建
  let header = newDocFile.getHeader();
  if (!header) header = newDocFile.addHeader();
  header.clear();
  const headerPara = header.appendParagraph(docIdMark);
  // 设置为浅灰色小字靠右对齐，降低存在感避免误编辑
  headerPara.setFontSize(8).setForegroundColor('#999999').setAlignment(DocumentApp.HorizontalAlignment.RIGHT);

  // 处理页脚：不存在则自动创建
  let footer = newDocFile.getFooter();
  if (!footer) footer = newDocFile.addFooter();
  footer.clear();
  const footerPara = footer.appendParagraph(docIdMark);
  footerPara.setFontSize(8).setForegroundColor('#999999').setAlignment(DocumentApp.HorizontalAlignment.RIGHT);

  // 写入完成后关闭新文档，避免批量运行时出现内容写入失败、超时问题
  newDocFile.saveAndClose();
}

关键改动说明 #

• 不再通过正则解析URL拿文档ID：创建新文档时直接调用getId()方法获取唯一标识，比字符串解析更稳定，不会因为Google Docs URL格式调整导致提取失败
• 补全页眉页脚兼容性逻辑：新创建的空白Google Doc默认不会初始化页眉、页脚区域，直接调用获取方法会返回null，脚本增加了自动创建逻辑，不会运行报错
• 低干扰样式设置：写入页眉页脚的ID统一设为8号浅灰色字、靠右对齐，和正文编辑区域做视觉区隔，大幅降低日常编辑时误改的概率
• 增加基础容错判断：如果光标不在有效文本位置、选中的文档名为空，会弹出明确提示，不会静默运行出错

迁移使用提示 #

后续做批量迁移时，先遍历所有导出的文档文件，优先从页眉、页脚匹配DocID:后面的字符串做新旧地址映射，只要两个区域有一个保留了原始ID，就能准确匹配到自建站的对应文档路径，不需要担心正文链接被修改导致匹配失败。

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