Google Apps Script无法清除文档项目符号的背景高亮色

问题出在：项目符号的背景色是绑定在**列表样式（List Style）**上的，不是ListItem或文本的直接属性。你之前改的都是文本内容的背景，根本没碰符号的样式背景，所以才会出现“文本变白、符号不变”的情况。

下面给两种可行的解决方法：

方法1：修改列表样式的背景色 #

直接找到项目符号所属的列表样式，把样式里的背景色改成白色，这样同列表的所有项目符号都会同步生效：

function clearAllListGlyphBackground(documentId) {
  const doc = DocumentApp.openById(documentId);
  const body = doc.getBody();
  const listItems = body.getListItems();
  
  listItems.forEach(item => {
    const listStyle = item.getListStyle();
    if (listStyle) {
      // 修改列表样式的背景色为白色
      listStyle.setAttributes({
        BACKGROUND_COLOR: '#ffffff'
      });
      // 同时确保文本部分的背景也是白色
      item.setAttributes({BACKGROUND_COLOR: '#ffffff'});
    }
  });

  // 顺便处理非列表段落的背景
  const paragraphs = body.getParagraphs();
  paragraphs.forEach(para => {
    if (!para.isListItem()) {
      para.setAttributes({BACKGROUND_COLOR: '#ffffff'});
    }
  });
}

方法2：重置列表为默认样式 #

如果不需要保留原列表的格式（比如缩进、符号样式），可以直接把列表样式重置为默认，项目符号的背景会自动变回白色：

function resetListsToDefault(documentId) {
  const doc = DocumentApp.openById(documentId);
  const body = doc.getBody();
  const listItems = body.getListItems();
  
  listItems.forEach(item => {
    // 清空原有列表样式
    item.setListStyle(null);
    // 可选：如果还需要保留项目符号，重新设置默认符号
    item.setGlyphType(DocumentApp.GlyphType.BULLET);
    // 确保文本背景为白色
    item.setAttributes({BACKGROUND_COLOR: '#ffffff'});
  });

  // 处理非列表段落的背景
  const paragraphs = body.getParagraphs();
  paragraphs.forEach(para => {
    if (!para.isListItem()) {
      para.setAttributes({BACKGROUND_COLOR: '#ffffff'});
    }
  });
}

补充说明 #

• 列表样式是批量生效的，同属一个列表的多个Item，修改其中一个的样式就会同步所有项，不需要重复处理。
• 两种方法都支持多级列表，能覆盖所有层级的项目符号背景色。

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