如何用python-docx确保Word文档各段落前间距一致？

尝试生成每个单词单独占一页的Word文档，要求每个段落前有特定间距，但设置的space_before并未一致生效，相同单词在不同页面的显示间距存在差异。

代码片段 #

from docx import Document
from docx.shared import Pt
from docx.oxml.ns import qn
from docx.enum.text import WD_ALIGN_PARAGRAPH
import os

def create_word_document(words, output_path):
    doc = Document()

    for word in words:
        p = doc.add_paragraph(word)
        run = p.runs[0]
        
        run.font.size = Pt(130)
        run.font.name = "Gulzar"
        run.element.rPr.rFonts.set(qn('w:eastAsia'), "Gulzar")
        
        p.alignment = WD_ALIGN_PARAGRAPH.CENTER
        p.paragraph_format.space_before = Pt(78)
        
        doc.add_page_break()

    os.makedirs(os.path.dirname(output_path), exist_ok=True)
    doc.save(output_path)
    print(f"Saved Word document to {output_path}")

# Example usage
words = ["کلجقم", "کلجقم", "کلجقم"]
output_path = "output.docx"
create_word_document(words, output_path)

修复方案 #

原因分析 #

Word对文档第一个段落的space_before渲染逻辑和后续段落不同：首段前无其他内容，部分space_before会被页面上边距抵消，导致视觉位置和后续页面不一致；同时直接修改段落格式可能继承默认样式的隐性属性，引发格式差异。

解决方法 #

1. 创建统一的自定义段落样式：彻底避免默认样式的干扰，确保所有段落使用完全一致的格式
2. 调整页面上边距：配合段落间距，抵消首段与后续段落的渲染差异

修改后的代码：

from docx import Document
from docx.shared import Pt, Inches
from docx.oxml.ns import qn
from docx.enum.text import WD_ALIGN_PARAGRAPH
from docx.enum.style import WD_STYLE_TYPE
import os

def create_word_document(words, output_path):
    doc = Document()

    # 创建自定义段落样式，统一所有格式属性
    custom_style = doc.styles.add_style('CenteredLargeWord', WD_STYLE_TYPE.PARAGRAPH)
    custom_style.font.size = Pt(130)
    custom_style.font.name = "Gulzar"
    custom_style.element.rPr.rFonts.set(qn('w:eastAsia'), "Gulzar")
    custom_style.paragraph_format.alignment = WD_ALIGN_PARAGRAPH.CENTER
    custom_style.paragraph_format.space_before = Pt(78)
    # 设置固定行距，避免字体大小导致的行距波动
    custom_style.paragraph_format.line_spacing = Pt(150)

    # 调整页面上边距，抵消首段space_before的渲染差异
    for section in doc.sections:
        section.top_margin = Inches(1)  # 可根据实际需求微调

    for word in words:
        # 使用自定义样式添加段落，确保格式完全统一
        doc.add_paragraph(word, style='CenteredLargeWord')
        doc.add_page_break()

    os.makedirs(os.path.dirname(output_path), exist_ok=True)
    doc.save(output_path)
    print(f"Saved Word document to {output_path}")

# Example usage
words = ["کلجقم", "کلجقم", "کلجقم"]
output_path = "output.docx"
create_word_document(words, output_path)

额外提示 #

• 若仍有细微差异，可尝试将space_before替换为「页面上边距 + 段落行距」的组合，Word对段落内行距的渲染稳定性更高
• 确保字体「Gulzar」在系统中正确安装，避免字体自动替换导致的大小、间距变化

内容的提问来源于stack exchange，提问作者Rashid mehmood