Google Apps Script将Google Sheet软换行转为Google Doc硬换行问题

你使用的replaceText()方法存在Google Docs API原生限制：所有传入的换行类字符（包括\n、\r\n）都会被自动转换为段内软换行（对应Shift+Enter输入效果，所有行继承当前段落的缩进属性），无法生成硬换行（对应Enter输入的段落分隔效果）。

核心逻辑是弃用replaceText()，先定位占位符位置，再将Sheet中按\n拆分的内容逐行以独立段落的形式插入文档，天然实现硬换行效果。

场景1：占位符单独占用一个段落（最常用场景） #

// 读取Sheet内容，按软换行拆分行为数组
const demoContentArr = ss.getRangeByName("SectionContentsDemo").getValue().toString().split("\n");
// 查找占位符位置
const searchResult = template_doc_body.findText("{{Section Contents - Demo}}");

if (searchResult) {
  const targetPara = searchResult.getElement().asParagraph();
  let insertIndex = template_doc_body.getChildIndex(targetPara);
  // 删掉原有占位符段落
  targetPara.removeFromParent();
  // 逐行插入新段落，每行就是一个独立段落（硬换行效果）
  demoContentArr.forEach(line => {
    const newPara = template_doc_body.insertParagraph(insertIndex, line);
    // 可选：同步原占位符段落的格式（缩进、字体、行高等）
    // newPara.setAttributes(targetPara.getAttributes());
    insertIndex++;
  });
}

场景2：占位符和其他文本在同一个段落内 #

const demoContentArr = ss.getRangeByName("SectionContentsDemo").getValue().toString().split("\n");
const searchResult = template_doc_body.findText("{{Section Contents - Demo}}");

if (searchResult) {
  const startOffset = searchResult.getStartOffset();
  const endOffset = searchResult.getEndOffsetInclusive();
  let currentPara = searchResult.getElement().asParagraph();
  // 先删除占位符文本
  currentPara.deleteText(startOffset, endOffset);
  let currentInsertPos = startOffset;
  // 逐行插入内容
  demoContentArr.forEach((line, idx) => {
    currentPara.insertText(currentInsertPos, line);
    currentInsertPos += line.length;
    // 非最后一行插入段落分隔
    if (idx !== demoContentArr.length - 1) {
      currentPara = currentPara.insertParagraphAfter(currentInsertPos);
      currentInsertPos = 0;
    }
  });
}

如果不需要拆分新段落，仅需要保留段内换行效果，直接使用insertText方法插入带\n的文本即可，不要使用replaceText方法。

内容的提问来源于stack exchange，提问作者Luis Alberto Delgado de la Flo