如何使用Google Apps Script在Google Doc指定关键词后换行插入新文本？

原有代码出错的核心原因是findText()返回的是RangeElement对象，getStartOffset()获取的是匹配文本在当前所属文本块内的相对偏移，不是整个文档正文的绝对位置，和insertText()要求的全局位置计数规则不匹配，所以插入位置会错位。

你可以根据自己的使用场景选择以下两种实现方案：

方案1：插入到关键词所在段落的下一行（推荐常规场景使用） #

适合关键词单独占行、或者你希望新内容作为独立段落插入在关键词所属段落之后的场景，不会打乱原有段落的排版格式。

function insertTextAfterKeyword(keyword, insertContent) {
  const theDoc = DocumentApp.getActiveDocument();
  const body = theDoc.getBody();
  // 查找文档中第一个匹配的关键词
  const matchedRange = body.findText(keyword);
  // 未匹配到关键词直接终止执行
  if (!matchedRange) return;

  // 获取匹配内容所属的段落元素
  const matchedPara = matchedRange.getElement().getParent().asParagraph();
  // 读取该段落在全文中的索引位置
  const paraIndex = body.getChildIndex(matchedPara);
  // 在该段落的下一个位置插入新段落，自动成为新的一行
  body.insertParagraph(paraIndex + 1, insertContent);
}

// 调用示例：查找关键词"li"，在下一行插入"需要新增的文本内容"
insertTextAfterKeyword("li", "需要新增的文本内容");

方案2：严格插入到关键词所在行的下一行（适合段落内有软换行的场景） #

如果你的文档中存在同一个段落内用Shift+Enter生成的软换行，需要严格在关键词所在行的下一行插入内容，可以用该方案计算全局绝对位置实现：

function insertAfterKeywordLine(keyword, insertContent) {
  const theDoc = DocumentApp.getActiveDocument();
  const body = theDoc.getBody();
  const matchedRange = body.findText(keyword);
  if (!matchedRange) return;

  // 获取匹配文本在当前文本块内的结束偏移
  const endOffset = matchedRange.getEndOffsetInclusive();
  // 获取当前文本块在整个文档中的绝对起始位置
  const elementStartPos = matchedRange.getElement().getStartOffset();
  // 计算关键词结束位置的全局绝对坐标
  const keywordEndAbsPos = elementStartPos + endOffset + 1;
  // 找到关键词结束后第一个换行符的全局位置
  const fullDocText = body.editAsText().getText();
  const nextLineBreakPos = fullDocText.indexOf('\n', keywordEndAbsPos);
  // 在下一行的开头插入目标内容
  body.editAsText().insertText(nextLineBreakPos + 1, insertContent + '\n');
}

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