### 使用 `python-docx` 修改 Word 文档中的目录 #### 背景说明 尽管 `python-docx` 提供了许多功能来创建和修改 `.docx` 文件的内容，但它并不直接支持动态更新或重新生成文档中的目录（Table of Contents, TOC）。这是因为目录通常是基于文档内容自动生成的，而这种行为依赖于 Microsoft Word 的内部机制。然而，可以通过间接方法实现对目录的手动调整。 #### 方法概述 如果需要使用 `python-docx` 来“修改”目录，则需手动定位并替换现有的目录项。以下是具体步骤： 1. **安装库** 如果尚未安装 `python-docx`，可以运行以下命令完成安装[^2]： ```bash pip install python-docx ``` 2. **加载目标文档** 打开包含目录的目标 Word 文档[^1]： ```python from docx import Document doc = Document('example.docx') ``` 3. **遍历段落找到目录位置** 目录通常位于文档开头部分，因此可通过遍历段落到特定样式（如 `TOC` 或其他标记）来识别其范围： ```python toc_paragraphs = [] for paragraph in doc.paragraphs: if 'toc' in paragraph.text.lower(): # 假设目录中有关键词"Toc" toc_paragraphs.append(paragraph) ``` 4. **手动更新目录条目** 对于已知的新章节名称及其页码，可以直接覆盖原有目录项的文字内容： ```python new_toc_entries = [ ("Introduction", "Page 1"), ("Chapter 1", "Page 5"), ("Conclusion", "Page 10") ] for i, (title, page) in enumerate(new_toc_entries): if i < len(toc_paragraphs): # 确保索引不越界 toc_paragraphs[i].text = f"{title}\t{page}" ``` 5. **保存更改后的文档** 将修改应用到原始文件中[^1]： ```python doc.save('modified_example.docx') ``` 需要注意的是，这种方法仅适用于简单的静态目录管理；对于复杂需求（例如自动计算页码），建议借助外部工具或者返回至 Microsoft Word 中执行最终渲染[^4]。 --- ### 示例代码总结 下面是一份完整的脚本示例，展示如何利用上述逻辑修改现有 Word 文档内的目录结构： ```python from docx import Document def update_toc(doc_path, output_path, entries): """ 更新指定路径下的Word文档中的目录 """ doc = Document(doc_path) # 查找所有可能属于目录的部分 toc_paragraphs = [p for p in doc.paragraphs if any(word in p.text.lower() for word in ['table', 'contents'])] # 替换旧有的目录条目为新的数据 for idx, entry in enumerate(entries[:len(toc_paragraphs)]): title, page_num = entry toc_paragraphs[idx].text = f'{title}{"." * (30 - len(title))}{page_num}' # 输出新版本文档 doc.save(output_path) if __name__ == "__main__": input_file = './input_with_toc.docx' output_file = './output_updated_toc.docx' updated_entries = [("Preface", "i"), ("Section A", "1"), ("Appendix B", "7")] update_toc(input_file, output_file, updated_entries) ``` ---