You need to enable JavaScript to run this app. 如何解决python-docx使用List Number样式时有序列表编号不重置的问题
优惠活动
大模型
产品
解决方案
定价
更多

如何解决python-docx使用List Number样式时有序列表编号不重置的问题

解决方法

要实现同一样式的多组有序列表各自从1开始计数,核心是给每组列表的第一个段落分配新的独立numId,Word中有序列表的编号连续性是通过numId属性关联的,同一numId下的同级别列表会自动连续编号,更换新的numId即可重置计数。

第一步:编写重置列表编号的工具函数

def restart_list_numbering(paragraph):
    # 获取段落的底层XML属性
    p = paragraph._p
    pPr = p.get_or_add_pPr()
    numPr = pPr.get_or_add_numPr()
    # 生成全新的numId
    next_num_id = paragraph.part.numbering_part.next_num_id
    numPr.get_or_add_numId().val = next_num_id
    # 设置编号级别为0,对应List Number的默认级别
    numPr.get_or_add_ilvl().val = 0
    # 将新的numId注册到文档的编号配置中
    numbering_part = paragraph.part.numbering_part
    numbering_part.num_lst.add_num(next_num_id, abstract_num_id=1)

注:默认List Number样式对应的abstractNumId为1,如果你使用自定义列表样式,可对应调整abstract_num_id参数

第二步:修改原有代码,每组新列表的第一个项调用上述函数

修改后的完整可运行代码如下:

# 导入docx库
import docx

# 定义重置编号的工具函数
def restart_list_numbering(paragraph):
    p = paragraph._p
    pPr = p.get_or_add_pPr()
    numPr = pPr.get_or_add_numPr()
    next_num_id = paragraph.part.numbering_part.next_num_id
    numPr.get_or_add_numId().val = next_num_id
    numPr.get_or_add_ilvl().val = 0
    numbering_part = paragraph.part.numbering_part
    numbering_part.num_lst.add_num(next_num_id, abstract_num_id=1)

# 创建文档实例
doc = docx.Document()

# 添加文档标题
doc.add_heading('GeeksForGeeks', 0)

# 第一组List Number列表
doc.add_heading('第一组 List Number 样式列表', 3)
doc.add_paragraph('有序列表第一项', style='List Number')
doc.add_paragraph('有序列表第二项', style='List Number')
doc.add_paragraph('有序列表第三项', style='List Number')

# 第二组List Number列表,第一个项调用函数重置编号
doc.add_heading('第二组 List Number 样式列表', 3)
p = doc.add_paragraph('有序列表第一项', style='List Number')
restart_list_numbering(p)
doc.add_paragraph('有序列表第二项', style='List Number')
doc.add_paragraph('有序列表第三项', style='List Number')

# 第三组List Number列表,第一个项调用函数重置编号
doc.add_heading('第三组 List Number 样式列表', 3)
p = doc.add_paragraph('有序列表第一项', style='List Number')
restart_list_numbering(p)
doc.add_paragraph('有序列表第二项', style='List Number')
doc.add_paragraph('有序列表第三项', style='List Number')

# 保存文档
doc.save('gfg.docx')

运行修改后的代码后,所有使用相同List Number样式的列表都会各自从1开始计数,不会出现跨组连续编号的问题。

内容的提问来源于stack exchange,提问作者template

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.14 21:54:07