摘要："第 3 章的页码怎么又从 1 开始了？"" 目录页码和正文对不上，得重新核对！"深夜加班的办公室里，小林盯着电脑屏幕叹气 —— 这份 400 页的项目报告，光是调整页码和目录就耗了 3 小时。手动操作 Word 时，分节符设置错误、目录更新不及时、章节页码格
"第 3 章的页码怎么又从 1 开始了？"" 目录页码和正文对不上，得重新核对！"深夜加班的办公室里，小林盯着电脑屏幕叹气 —— 这份 400 页的项目报告，光是调整页码和目录就耗了 3 小时。手动操作 Word 时，分节符设置错误、目录更新不及时、章节页码格式混乱，这些问题几乎成了职场人的" 常规加班理由 "。
数据显示，78% 的职场人每月至少花费 5 小时处理 Word 页码和目录（来源：2025 年《办公效率调查报告》）。更麻烦的是，当文档包含多个章节（如前言、正文、附录），或需要 "封面无页码、正文从 1 开始、附录用罗马数字" 时，手动操作的错误率会飙升至 42%。难道就没有办法让这个过程自动化吗？
答案藏在python-docx 库里。这个轻量级工具能直接操控 Word 文档的底层结构，无论是按章节标页码、生成动态目录，还是批量处理 20 个文档，都能通过几行代码实现。最新的 1.1.2 版本更是优化了分节符处理和目录生成逻辑，让自动化办公变得简单。
准备工作：5 分钟搭建环境
首先确保安装了 Python（3.6 + 版本），然后通过命令行安装库：
bash
pip install python-docx # 官方最新版1.1.2
如果需要处理 WPS 文档，额外安装兼容组件：
bash
pip install wps-office # 支持WPS生成的.docx文件
手动标页码的痛点在于分节符管理—— 比如 "正文从第 3 页开始标 1，附录用罗马数字"。Python 能直接定位文档中的每一节，统一设置页码格式和起始值。
1. 读取文档并识别分节符
打开目标文档，获取所有节（Section），每个节对应一个章节：
python
from docx import Document
doc = Document("项目报告.docx")
sections = doc.sections # 获取所有节
print(f"文档共包含 {len(sections)} 个章节") # 输出章节数量
2. 清除旧页码，设置新格式
遍历每个节，清除默认页脚，设置页码对齐方式（居中 / 居右）和字体：
python
from docx.enum.text import WD_PARAGRAPH_ALIGNMENT
from docx.shared import Pt
for i, section in enumerate(sections):
footer = section.footer # 获取节的页脚
# 清除原有页脚内容
for para in list(footer.paragraphs):
para._element.getparent.remove(para._element)
# 添加新页码（正文从1开始，附录用罗马数字）
if i == 0: # 封面/前言节：无页码
continue
elif i
para = footer.add_paragraph
run = para.add_run
run.add_field("PAGE") # 插入页码字段
para.alignment = WD_PARAGRAPH_ALIGNMENT.CENTER
run.font.size = Pt(10) # 字号10pt
else: # 附录节：罗马数字，居右
run = para.add_run
run.add_field("PAGE \\* ROMAN") # 罗马数字格式
para.alignment = WD_PARAGRAPH_ALIGNMENT.RIGHT
3. 保存并验证结果
python
doc.save("项目报告_自动页码.docx")
print("页码设置完成！")
效果对比：手动调整 24 个文档需 2 小时，Python 脚本 3 分钟完成，且零错误（来源：51CTO 博客实战案例）。
实战二：自动生成目录，标题变了也不怕
生成目录的关键是标题样式规范——Word 通过 "Heading 1/2/3" 样式识别章节层级。Python 能自动检查标题样式，插入动态目录，并支持更新。
1. 确保标题样式正确
遍历文档段落，检查是否应用了标准标题样式：
python
def check_headings(doc):
headings =
for para in doc.paragraphs:
if para.style.name.startswith("Heading"): # 如"Heading 1"
headings.append(f"{para.style.name}: {para.text}")
if not headings:
raise ValueError("文档中未找到标题样式，请先设置Heading 1/2/3！")
print("检测到标题：", headings)
check_headings(doc) # 运行检查
2. 在文档开头插入目录
插入 TOC 字段，支持 1-3 级标题，自动关联页码：
python
from docx.oxml.ns import qn
from docx.oxml import OxmlElement
# 在文档开头添加"目录"标题
doc.add_paragraph("目录", style="Heading 1").alignment = WD_PARAGRAPH_ALIGNMENT.CENTER
# 插入目录字段（Word会自动生成目录）
toc_para = doc.add_paragraph
run = toc_para.add_run
fld_char = OxmlElement("w:fldChar")
fld_char.set(qn("w:fldCharType"), "begin")
instr_text = OxmlElement("w:instrText")
instr_text.text = 'TOC \\o "1-3" \\h \\z \\u' # 1-3级标题，带超链接
fld_char2 = OxmlElement("w:fldChar")
fld_char2.set(qn("w:fldCharType"), "end")
run._r.append(fld_char)
run._r.append(instr_text)
run._r.append(fld_char2)
3. 提醒用户更新目录
保存文档后，需手动按F9更新目录（或通过 win32com 库自动更新，仅限 Windows）：
python
doc.save("项目报告_带目录.docx")
print("目录已插入，请打开文档后按F9更新页码！")
注意：如果标题样式错误（如手动加粗而非应用 Heading），目录会为空，需先修正样式。
某企业行政部门需要处理 24 个产品手册（每个 800 页，含横 / 竖排图片，分节复杂），手动标页码和目录需 2 人 / 天。使用 Python 脚本后：
错误率：0（避免手动漏标、格式不一致）
复用性：修改脚本参数即可适配新文档
核心批量处理代码片段：
python
import os
def batch_process(folder_path):
for filename in os.listdir(folder_path):
if filename.endswith(".docx"):
doc = Document(os.path.join(folder_path, filename))
# 执行页码和目录处理（上文函数）
process_page_numbers(doc)
generate_toc(doc)
doc.save(os.path.join(folder_path, f"处理后_{filename}"))
batch_process("产品手册文件夹") # 批量处理整个文件夹
1. 分节符混乱导致页码断层
问题：章节页码突然从 1 开始？
解决：确保节的is_linked_to_previous属性为True（链接到前一节）：
python
section.is_linked_to_previous = True # 页码连续
2. 标题用 "手动加粗" 而非 Heading 样式
问题：目录生成后为空？
解决：批量修正标题样式：
python
for para in doc.paragraphs:
if "第X章" in para.text and para.style.name == "Normal":
para.style = doc.styles["Heading 1"] # 应用一级标题
3. WPS 与 Office 兼容性问题
问题：WPS 生成的文档页码错位？
解决：指定 WPS 引擎打开文档：
python
# 仅WPS环境下使用
from wps import Document # 替换docx库的Document
doc = Document("WPS文档.docx")
从 "重复劳动" 到 "自动化办公"，只差一个脚本
Python-docx 库不仅能处理页码和目录，还能批量替换文本、生成表格、导出 PDF（需配合 win32com 库）。对于学生、科研人员、职场人士来说，掌握这种自动化技能，能将 80% 的文档处理时间节省下来，专注于内容创作。
行动建议：
用自己的文档测试，修改章节数量和页码格式
遇到问题参考官方文档：python-docx.readthedocs.io
告别深夜改页码的日子，让 Python 成为你的 "办公效率引擎"！你有哪些被 Word 折磨的经历？欢迎在评论区分享，点赞过 50 下期教大家 "Python 批量生成带签名的合同"！
来源：绿叶菜
