python-docx高级用法：页眉页脚、分节和格式设置的终极指南

郜里富

499人浏览 · 2026-03-13 02:03:00

郜里富 · 2026-03-13 02:03:00 发布

python-docx高级用法：页眉页脚、分节和格式设置的终极指南

【免费下载链接】python-docx Create and modify Word documents with Python 项目地址: https://gitcode.com/gh_mirrors/py/python-docx

python-docx是一个强大的Python库，让你能够轻松创建和修改Word文档。本文将深入探讨其高级功能，包括页眉页脚设计、分节管理和格式设置技巧，帮助你制作专业级文档。

一、掌握页眉页脚：打造专业文档外观

页眉页脚是文档专业性的重要体现，它们不仅能展示页码，还能呈现标题、作者等关键信息。python-docx提供了灵活的页眉页脚控制功能，让你轻松实现各种复杂布局。

1.1 基础页眉设置：快速添加文档标题

每个Word文档的节(Section)都可以拥有独立的页眉。通过section.header属性，你可以访问并修改页眉内容：

document = Document()
section = document.sections[0]
header = section.header
paragraph = header.paragraphs[0]
paragraph.text = "Title of my document"

图：设置简单页眉后的文档效果，标题显示在页面顶部

1.2 高级页眉布局：多区域内容设计

利用制表位(Tab)可以创建包含左、中、右三个区域的页眉布局，这在制作包含文档标题、章节名和页码的复杂页眉时特别有用：

paragraph = header.paragraphs[0]
paragraph.text = "Left Text\tCenter Text\tRight Text"
paragraph.style = document.styles["Header"]

图：使用制表位实现的多区域页眉布局

1.3 页眉继承与链接：高效管理多节文档

在多节文档中，页眉默认会"链接到前一节"，即继承前一节的页眉设置。你可以通过is_linked_to_previous属性控制这一行为：

# 解除与前一节页眉的链接，创建新页眉
section.header.is_linked_to_previous = False

# 重新链接到前一节页眉，删除当前页眉内容
section.header.is_linked_to_previous = True

二、分节技术：实现复杂文档布局

分节(Section)是Word文档中实现复杂布局的核心功能。通过创建不同的节，你可以为文档的不同部分设置不同的页面方向、页边距和页眉页脚。

2.1 访问和管理文档节

文档的所有节都存储在document.sections集合中，你可以像列表一样访问它们：

# 获取文档中的所有节
sections = document.sections

# 访问第一个节
first_section = sections[0]

# 遍历所有节
for section in sections:
    print(section.start_type)

2.2 添加新节：控制文档布局变化

使用document.add_section()方法可以在文档末尾添加新节，新节将包含后续添加的所有内容：

from docx.enum.section import WD_SECTION

# 在文档末尾添加新节，从奇数页开始
new_section = document.add_section(WD_SECTION.ODD_PAGE)

2.3 节属性设置：自定义页面布局

每个节都提供了丰富的属性来控制页面布局，包括页面方向、尺寸和边距等：

from docx.shared import Inches
from docx.enum.section import WD_ORIENT

# 将页面方向改为横向
section.orientation = WD_ORIENT.LANDSCAPE
# 交换宽高以适应横向布局
new_width, new_height = section.page_height, section.page_width
section.page_width = new_width
section.page_height = new_height

# 设置页边距
section.left_margin = Inches(1.5)
section.right_margin = Inches(1)
section.top_margin = Inches(1)
section.bottom_margin = Inches(1)

三、格式设置：提升文档专业度

python-docx提供了全面的格式设置功能，让你能够精确控制文档的外观，从段落对齐到字体样式，再到表格格式。

3.1 段落格式：控制文本布局

通过段落格式设置，你可以控制对齐方式、行距、缩进等重要文本布局属性：

from docx.enum.text import WD_ALIGN_PARAGRAPH
from docx.shared import Pt

paragraph = document.add_paragraph("这是一个居中对齐的段落")
# 设置段落居中对齐
paragraph.alignment = WD_ALIGN_PARAGRAPH.CENTER
# 设置行距
paragraph.paragraph_format.line_spacing = 1.5
# 设置首行缩进
paragraph.paragraph_format.first_line_indent = Pt(12)

3.2 字体样式：打造视觉层次

通过字体样式设置，你可以突出重要内容，创建清晰的视觉层次结构：

from docx.shared import RGBColor, Pt
from docx.enum.text import WD_UNDERLINE

run = paragraph.add_run("这是加粗的红色文本")
# 设置字体
run.font.name = "微软雅黑"
# 设置字号
run.font.size = Pt(14)
# 设置加粗
run.bold = True
# 设置字体颜色
run.font.color.rgb = RGBColor(255, 0, 0)
# 设置下划线
run.underline = WD_UNDERLINE.SINGLE

3.3 表格格式：组织复杂数据

表格是呈现结构化数据的理想选择，python-docx提供了丰富的表格格式设置选项：

from docx.enum.table import WD_TABLE_ALIGNMENT
from docx.shared import Cm

# 添加一个3x3的表格
table = document.add_table(rows=3, cols=3)
# 设置表格居中对齐
table.alignment = WD_TABLE_ALIGNMENT.CENTER
# 设置列宽
for column in table.columns:
    column.width = Cm(3)
# 合并单元格
table.cell(0, 0).merge(table.cell(0, 2))

四、实战应用：创建专业文档模板

结合上述功能，你可以创建功能完善的专业文档模板。以下是一个综合示例，展示如何创建一个包含封面、目录和多节内容的完整文档：

from docx import Document
from docx.enum.section import WD_SECTION
from docx.enum.text import WD_ALIGN_PARAGRAPH
from docx.shared import Inches, Pt

# 创建文档对象
document = Document()

# 添加封面
document.add_heading('Python自动化报告', 0).alignment = WD_ALIGN_PARAGRAPH.CENTER
document.add_paragraph('').add_run('生成日期: 2023-10-01').italic = True

# 添加分节符，新节从新页开始
document.add_section(WD_SECTION.NEW_PAGE)

# 设置目录
document.add_heading('目录', level=1)
document.add_paragraph('1. 引言 ................................................ 1')
document.add_paragraph('2. 方法 ................................................ 2')

# 添加分节符
document.add_section(WD_SECTION.NEW_PAGE)

# 设置页眉页脚
section = document.sections[-1]
section.header.paragraphs[0].text = "Python自动化报告"
section.footer.paragraphs[0].text = "第 {PAGE} 页，共 {NUMPAGES} 页"

# 保存文档
document.save('专业报告.docx')