Google Docs插件开发：如何将软回车替换为硬换行

要把Google Docs里的软回车（\v）转换成真正的新段落，不能用body.replaceText()——因为在单个段落内插入\n仍然会被解析为软回车。得直接操作段落元素，拆分原段落并创建新段落，具体实现代码如下：

function replaceSoftReturnsWithNewParagraphs() {
  const doc = DocumentApp.getActiveDocument();
  const body = doc.getBody();
  const paragraphs = body.getParagraphs();
  
  // 倒序遍历，避免插入/删除段落导致索引错乱
  for (let i = paragraphs.length - 1; i >= 0; i--) {
    const currentPara = paragraphs[i];
    const paraText = currentPara.getText();
    
    if (paraText.includes('\v')) {
      const textParts = paraText.split('\v');
      // 把第一部分留在原段落
      currentPara.setText(textParts[0]);
      
      // 剩余部分依次创建新段落，复制原段落的样式
      for (let j = 1; j < textParts.length; j++) {
        const newParagraph = body.insertParagraph(i + j, textParts[j]);
        newParagraph.setAttributes(currentPara.getAttributes());
      }
    }
  }
}

关键说明 #

• 倒序遍历：如果正序处理，插入新段落会改变后续段落的索引，导致漏处理或重复处理。倒序遍历能避免这个问题。
• 样式继承：通过setAttributes(currentPara.getAttributes())让新段落完全继承原段落的格式（包括标题级别、字体、对齐方式等），拆分后的每个段落可以独立设置样式，解决你提到的“部分文本设为标题时整段变标题”的问题。
• 精准拆分：按\v拆分原段落文本，确保每个软回车的位置都被拆分成独立段落，完全替代软回车的作用。

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