Apps Script：如何定位Google文档中标题/Bookmark下的图片

1. 基于元素位置顺序遍历 #

Google Docs内容按线性顺序存储，可通过位置范围关联图片与Heading：

• 先遍历所有带Bookmark的Heading，用getRange()记录每个Heading的起始、结束位置。
• 遍历所有inline图片，获取每张图片的位置范围。
• 对比位置：若图片起始位置在当前Heading结束后、下一个Heading起始前，即可判定属于当前Heading。
• 红框首图可额外结合出现顺序（取该区块内第一张符合位置条件的图片），或检查图片的alt文本/描述（若标注时设置了专属标识）。

2. 利用标题段落层级关联 #

如果Heading使用Docs内置标题样式（如Heading 1/2/3），可通过层级划分区块：

• 遍历每个标题段落，逐个检查后续段落元素，直到遇到同级别或更高级别的标题为止。
• 过程中收集的所有inline图片，都属于当前Heading对应的产品区块。
• 核心代码思路：

const doc = DocumentApp.getActiveDocument();
const body = doc.getBody();
const elements = body.getParagraphs();

let currentHeading = null;
for (let i = 0; i < elements.length; i++) {
  const elem = elements[i];
  const headingType = elem.getHeading();
  // 匹配目标标题级别（示例为Heading 2）
  if (headingType === DocumentApp.ParagraphHeading.HEADING2) {
    const bookmarks = elem.getBookmarks();
    if (bookmarks.length > 0) {
      currentHeading = { paragraph: elem, bookmark: bookmarks[0] };
      // 向后遍历收集图片，直到遇到同级/高级标题
      let j = i + 1;
      while (j < elements.length) {
        const nextElem = elements[j];
        const nextHeading = nextElem.getHeading();
        if (nextHeading <= headingType) break;
        // 提取段落内图片
        const images = nextElem.getImages();
        if (images.length > 0 && !currentHeading.firstImage) {
          currentHeading.firstImage = images[0]; // 记录首图
        }
        j++;
      }
    }
  }
}

3. 结合表格边界划分区块 #

每个产品包含表格单元格，可借助表格作为区块边界：

• 找到Heading之后的第一个表格（按位置顺序），该表格的结束位置即为当前产品区块的边界。
• Heading之后到表格结束位置之间的图片，以及表格内的图片，都归属于当前产品。
• 红框首图若在表格上方，取Heading后表格前的第一张图片；若在表格内，取对应单元格的第一张图片。

4. 自定义标记快速定位首图 #

若可修改输入Doc，给红框首图添加专属标记：

• 选中首图，右键设置Alt text，在描述中加入特定标识（如[product-main-image]）。
• 脚本中通过getAltDescription()检查标识，快速定位首图，再结合位置判断所属Heading。

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