python-docx生成项目符号大小不一致问题求助

你遇到的项目符号大小差异，核心原因是项目符号的字体/大小是由Word的编号定义（Numbering Definition）控制的，和段落文本的字体设置无关。你之前硬编码numId="1"，这个ID对应的是Word默认的编号样式，其符号大小和模板中自定义的项目符号样式不匹配；另外缺少缩进级别（ilvl）的设置，也会导致Word渲染时使用异常的符号尺寸。

即使全用代码生成列表，第一个符号偏小的问题，是因为第一个段落的编号属性（numPr）没有正确关联到模板的编号定义，Word fallback到了默认的小符号样式。

核心思路是复用模板中已有的项目符号编号定义，而不是硬编码默认ID。步骤如下：

1. 从模板中提取已有项目符号段落的numId（编号ID）和ilvl（缩进级别）
2. 给所有新增的列表段落应用相同的编号属性
3. 优化段落插入逻辑，避免手动操作底层OXML导致的样式丢失

1. 提取模板中的列表设置 #

from docx import Document
from docx.shared import Pt
from docx.oxml import OxmlElement
from docx.oxml.ns import qn
from docx.text.paragraph import Paragraph

def get_list_settings(paragraph):
    """从段落中提取编号ID和缩进级别"""
    pPr = paragraph._p.get_or_add_pPr()
    numPr = pPr.find(qn('w:numPr'))
    if not numPr:
        return None, None
    numId = numPr.find(qn('w:numId'))
    ilvl = numPr.find(qn('w:ilvl'))
    return (
        numId.get(qn('w:val')) if numId else None,
        ilvl.get(qn('w:val')) if ilvl else "0"  # 默认级别0
    )

2. 重构列表设置函数 #

def apply_list_style(paragraph, num_id, ilvl):
    """给段落应用指定的编号样式"""
    p = paragraph._p 
    pPr = p.get_or_add_pPr() 
    
    # 先移除已有的编号属性，避免冲突
    existing_numPr = pPr.find(qn('w:numPr'))
    if existing_numPr:
        pPr.remove(existing_numPr)
    
    numPr = OxmlElement('w:numPr')
    # 添加缩进级别
    ilvl_elem = OxmlElement('w:ilvl')
    ilvl_elem.set(qn('w:val'), ilvl)
    numPr.append(ilvl_elem)
    # 添加编号ID
    numId = OxmlElement('w:numId') 
    numId.set(qn('w:val'), num_id) 
    numPr.append(numId) 
    pPr.append(numPr)

3. 优化段落插入逻辑 #

def insert_paragraph_after(paragraph, text, style="List Paragraph"):
    """更可靠的段落插入方式，避免手动创建OXML元素"""
    new_para = paragraph._parent.add_paragraph(text, style=style)
    # 将新段落移动到目标段落之后
    paragraph._p.addnext(new_para._p)
    # 设置文本字体
    for run in new_para.runs:
        run.font.size = Pt(10)
        run.font.name = 'Arial'
    return new_para

4. 主逻辑调用 #

template_document = Document("my_word_file.docx")

# 第一步：从模板中获取目标列表的编号设置
target_num_id = None
target_ilvl = None
# 先找包含占位符的段落
for para in template_document.paragraphs:
    if "[[FRUIT_ITEM]]" in para.text:
        target_num_id, target_ilvl = get_list_settings(para)
        # 如果占位符段落没有列表样式，就找文档中其他项目符号段落
        if not target_num_id:
            for p in template_document.paragraphs:
                nid, il = get_list_settings(p)
                if nid:
                    target_num_id = nid
                    target_ilvl = il
                    break
        break

template_variables = {
    "[[FRUIT_ITEM]]": ['Apple', 'Banana', 'Pear', 'Pineapple'],
    "[[CHEESE_TYPE]]": ['mild', 'sharp']
}

# 替换占位符并生成列表
for variable_key, variable_value in template_variables.items():
    if variable_key != "[[FRUIT_ITEM]]":
        continue
    for paragraph in template_document.paragraphs:
        if variable_key in paragraph.text:
            # 替换占位符为第一个列表项
            for run in paragraph.runs:
                if variable_key in run.text:
                    run.text = run.text.replace(variable_key, variable_value[0])
            # 给原段落应用列表样式（如果之前没有）
            if target_num_id:
                apply_list_style(paragraph, target_num_id, target_ilvl)
            # 添加剩余列表项
            if len(variable_value) > 1:
                prev_para = paragraph
                for fruit in variable_value[1:]:
                    new_bullet = insert_paragraph_after(prev_para, fruit)
                    apply_list_style(new_bullet, target_num_id, target_ilvl)
                    prev_para = new_bullet

# 保存文档
template_document.save("output.docx")

• 项目符号的样式完全由Word的编号定义控制，所以必须复用模板中已有的numId才能保证符号大小一致
• ilvl（缩进级别）是必要属性，不同级别对应不同的符号样式，缺失会导致Word使用默认渲染逻辑
• 避免手动创建w:p元素，使用add_paragraph方法能更好地继承文档样式

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