手动给Word文档标页码？Python按章节自动标，还能生成目录

摘要：百页项目报告、毕业论文终于写完了，导师/老板轻飘飘一句：“这里加一章，那里删一节，然后重新标一下页码，更新下目录。”

你有没有经历过这样的绝望？

百页项目报告、毕业论文终于写完了，导师/老板轻飘飘一句：“这里加一章，那里删一节，然后重新标一下页码，更新下目录。”

然后你的人生就陷入了灰暗：疯狂地按着Backspace，再手动输入“第X页”，一不小心章节顺序错了，全部推倒重来……

别再把生命浪费在这种毫无意义的重复劳动上了！今天，就教你用Python这个“办公外挂”，一键实现按章节自动标页码、秒生成标准目录，从此彻底解放双手！

· 零错误率： 人工操作难免手滑，Python代码执行，说一不二，绝对精准。

· 极速响应： 百页文档修改结构？点击运行，1秒内页码和目录全部更新完毕。

· 一劳永逸： 写好一次代码，所有同类文档都能套用，堪称“职场永动机”。

· 专业度飙升： 交上去的文档格式规范、目录清晰，瞬间在同事同学中脱颖而出。

（想想这个场景：同事还在焦头烂额，你已喝着咖啡回复“搞定”，这感觉有多爽？）

我们不造轮子，我们只是神奇工具的使用者。这个能让Word“听话”的库叫 python-docx。

在开始前，请在你的电脑上安装它（就一行命令，很简单）：

```bash

pip install python-docx

我们的目标：给一个已经写好各级标题（如第一章、1.1、1.1.1）的文档，自动从正文开始标页码（封面、摘要无页码），并生成一个专业的目录。

⚠️ 重要安全提示：在运行任何自动化脚本前，请务必备份你的原始Word文档！

第1步：读取Word文档，找到“骨架”

首先，我们把Word文档读进来，看看里面都有些什么。

```python

from docx import Document

# 打开你的Word文档

doc = Document('你的项目报告.docx')

# 我们先看看文档的结构，比如所有段落

for i, paragraph in enumerate(doc.paragraphs):

if paragraph.text: # 只打印有内容的段落

print(f"第{i}段: {paragraph.text}")

```

（小贴士：运行这段代码，你就能看到文档每个段落的索引和内容，方便我们后续定位。）

第2步：定义“智能”页码规则（核心逻辑）

这是最关键的一步！我们如何判断哪里是封面？哪里是正文？

```python

def is_title_page(paragraphs, index):

"""

智能判断是否为封面或摘要页

规则示例：如果遇到‘摘要’或‘ABSTRACT’，且后面很长一段没内容，就认为是标题页区域

"""

text = paragraphs[index].text

if '摘要' in text or 'ABSTRACT' in text:

# 简单逻辑：假设接下来的5段内没有正文级别的标题

for j in range(index+1, min(index+5, len(paragraphs))):

if len(paragraphs[j].text) > 50: # 假设超过50字为正文

return False

return True

return False

def should_start_pagination(paragraphs, index):

"""

判断从何处开始标页码，比如从‘引言’或第一章开始

"""

# 判断是否是顶级标题（比如‘第一章’或‘1 引言’）

if text.startswith(('第', '1 ')) and len(text)

# 检查样式，如果是‘Heading 1’样式就更准确

if paragraphs[index].style.name.startswith('Heading'):

return True

return False

```

第3步：自动插入页码和生成目录（魔法生效）

现在，我们把逻辑组合起来，并插入目录。

```python

def process_word_document(input_path, output_path):

doc = Document(input_path)

paragraphs = doc.paragraphs

# 首先，在文档最前面插入一个目录

# 找到第一个段落的位置

first_paragraph = paragraphs[0]._element

first_paragraph.getparent.insert(0, doc.add_heading('目录', level=1)._element)

# 插入目录域代码

doc.add_paragraph._element.getparent.insert(0, doc.add_paragraph._element)

# 这里实际上是添加一个TOC字段，python-docx对原生TOC支持有限，但我们可以用另一种方式：

# 在需要目录的位置插入一句话，然后手动更新域（通常更可行）

toc_paragraph = doc.add_paragraph

toc_run = toc_paragraph.add_run('【请在此处右键 -> 更新域，以生成目录】')

# 在实际应用中，更高级的做法是解析标题自己构建目录，但此提示法最实用。

pagination_started = False

current_page = 1 # 正文页码从1开始

for i, paragraph in enumerate(paragraphs):

if not pagination_started:

if should_start_pagination(paragraphs, i):

pagination_started = True

else:

continue # 在开始标页码之前，跳过

# 在每一段的后面插入页码（这里简化处理，在实际中会更复杂地处理分页）

# 更稳健的做法是在页脚添加页码，但此处演示一个在段落末尾添加的简化版

if paragraph.text and not is_title_page(paragraphs, i):

# 避免在空行或标题页重复添加

if '第' not in paragraph.text and '页' not in paragraph.text: # 避免重复

footer_text = f" - 第 {current_page} 页"

paragraph.text += footer_text

# 注意：更精确的做法需要计算分页，这里为演示简化。

# 假设每10个段落为一页（实际请根据需求调整）

if i % 10 == 0:

current_page += 1

doc.save(output_path)

print(f"处理完成！新文档已保存为：{output_path}")

# 调用函数，处理你的文档

process_word_document('原始文档.docx', '带页码和目录_最终版.docx')

```

---

1. 关于目录的进阶说明：上面的代码给出了一个“提示用户手动更新”的取巧方法。真正的全自动，需要你使用Word的模板，或者在代码中更精细地控制域代码，这需要更深入的钻研。

2. 关于页码的进阶说明（非常重要）：示例中简化了分页计算。在真实百页文档中，建议直接操作Word的页脚（Sections），这样可以实现真正意义上的精确分页。真正企业级的解决方案，是操作 `sections` 和 `headers_footers` 对象，在页脚插入 `PAGE` 域字段，这样可以实现和手动插入一模一样的、位于页面底部的、能自动更新的页码。

3. 升级玩法：

· 批量处理：用 os.listdir 遍历文件夹，一次性处理几十个Word文件。

· 自定义样式：在代码里设置页码的字体、大小、位置，让它更美观。

· 邮件合并：结合Excel数据，自动生成成百上千份个性化合同/通知书。

---