如何用GAS按字母顺序排序Google Docs分页符分隔的Heading1章节

核心思路 #

1. 提取完整章节：遍历文档所有元素，将每个Heading1标题到下一个分页符（或文档末尾）之间的所有元素打包为章节对象（含标题和元素列表）
2. 排序章节：基于章节标题的字母顺序完成排序
3. 重构文档：将排序后的章节依次插入新文档（或覆盖原文档），完整保留章节内格式与内容

完整实现代码 #

function sortChaptersByHeading1() {
  const sourceDoc = DocumentApp.getActiveDocument();
  const sourceBody = sourceDoc.getBody();
  const elements = sourceBody.getChildren();
  
  // 存储章节对象：{ title: 标题文本, elements: 章节包含的所有元素 }
  const chapters = [];
  let currentChapter = null;

  // 遍历提取章节
  for (let i = 0; i < elements.length; i++) {
    const element = elements[i];
    const elementType = element.getType();

    // 触发新章节：遇到非空Heading1
    if (elementType === DocumentApp.ElementType.PARAGRAPH) {
      const para = element.asParagraph();
      if (para.getHeading() === DocumentApp.ParagraphHeading.HEADING1 && para.getText().trim() !== "") {
        // 先保存上一个未完成的章节
        if (currentChapter) chapters.push(currentChapter);
        // 初始化新章节
        currentChapter = {
          title: para.getText().trim(),
          elements: [element]
        };
        continue;
      }
    }

    // 结束当前章节：遇到分页符
    if (elementType === DocumentApp.ElementType.PAGE_BREAK) {
      if (currentChapter) {
        currentChapter.elements.push(element);
        chapters.push(currentChapter);
        currentChapter = null;
      }
      continue;
    }

    // 收集当前章节的元素
    if (currentChapter) currentChapter.elements.push(element);
  }

  // 处理文档末尾无分页符的章节
  if (currentChapter) chapters.push(currentChapter);

  // 按标题字母顺序排序（支持多语言自然排序）
  const sortedChapters = chapters.sort((a, b) => a.title.localeCompare(b.title));

  // 创建新文档存放排序结果
  const targetDoc = DocumentApp.create("排序后的文档");
  const targetBody = targetDoc.getBody();

  // 批量添加排序后的章节
  sortedChapters.forEach((chapter, index) => {
    chapter.elements.forEach(element => {
      // 复制元素到新文档，避免破坏原文档
      targetBody.appendChild(element.copy());
    });
    // 最后一个章节不加分页符
    if (index !== sortedChapters.length - 1) {
      targetBody.appendPageBreak();
    }
  });

  targetDoc.saveAndClose();
  Logger.log(`排序完成，新文档ID：${targetDoc.getId()}`);
}

关键细节说明 #

1. 章节提取逻辑 #

• 严格区分Heading1（章节起始）和分页符（章节结束），确保每个章节包含标题、正文、格式元素（图片、列表等）及分页符
• 处理文档末尾无分页符的边界情况，避免遗漏最后一个章节

2. 元素操作优化 #

• 使用copy()复制元素而非直接移动，防止原文档结构被破坏；若需覆盖原文档，可先执行sourceBody.clear()再添加排序后的元素
• 保留所有格式属性，效果等同于手动剪切粘贴

3. 调试优化 #

在遍历过程中添加日志，可直观查看章节内容：

// 示例：在收集元素时添加日志
if (currentChapter) {
  currentChapter.elements.push(element);
  // 打印元素类型和文本（仅文本元素有效）
  if (element.getType() === DocumentApp.ElementType.TEXT) {
    Logger.log(`章节${currentChapter.title}添加元素：${element.asText().getText()}`);
  }
}

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