Google Apps Script中多级项目符号列表转为编号列表问题

问题分析 #

你遇到的问题根源在于：单独为每个列表项设置符号类型、层级和缩进时，没有将它们关联到同一个列表样式组。Google Docs会默认将未关联统一样式的顶级列表项识别为编号列表，而强制设置所有层级为0则会丢失原有的嵌套结构。

解决方案1：复用原列表样式（推荐） #

直接复制原列表项的样式和层级，完全保留原格式，适合从原文档提取列表的场景：

function myFunction() {
  const body = DocumentApp.getActiveDocument().getBody();
  const listItems = body.getListItems();
  
  body.appendHorizontalRule();

  // 遍历原列表项，复制文本和格式
  listItems.forEach(item => {
    const newItem = body.appendListItem(item.getText());
    newItem.setListStyle(item.getListStyle()); // 复用原列表样式
    newItem.setNestingLevel(item.getNestingLevel()); // 保留原层级
  });
}

解决方案2：自定义多级列表样式 #

如果需要自定义列表格式（而非完全复用原样式），需创建统一的ListStyle对象，为每个层级配置符号和缩进，再将所有列表项关联到该样式：

function myFunction() {
  const body = DocumentApp.getActiveDocument().getBody();
  const listItems = body.getListItems();
  
  body.appendHorizontalRule();

  // 创建新的多级列表样式
  const customListStyle = DocumentApp.createListStyle();
  // 配置层级0：实心项目符号，缩进36pt
  customListStyle.setGlyphType(0, DocumentApp.GlyphType.BULLET);
  customListStyle.setIndentStart(0, 36);
  // 配置层级1：空心项目符号，缩进72pt
  customListStyle.setGlyphType(1, DocumentApp.GlyphType.HOLLOW_BULLET);
  customListStyle.setIndentStart(1, 72);

  // 添加列表项并关联统一样式
  body.appendListItem(listItems[0].getText())
    .setListStyle(customListStyle)
    .setNestingLevel(0);

  body.appendListItem(listItems[1].getText())
    .setListStyle(customListStyle)
    .setNestingLevel(1);

  body.appendListItem(listItems[2].getText())
    .setListStyle(customListStyle)
    .setNestingLevel(1);
}

关键说明 #

• Google Docs的多级列表依赖ListStyle对象作为统一标识，所有属于同一列表的项必须关联同一个ListStyle，才能保持层级和符号的一致性。
• 避免单独为每个列表项设置setGlyphType和setIndentStart，这些配置应统一在ListStyle中定义，再绑定到列表项。

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