如何用Python docx或C#复制Word标题下带样式的段落至新文档

阿华AIGC实验室

2026-5-12

解决Python-docx复制自定义样式段落的问题

我来帮你搞定这个问题——你遇到的核心痛点是python-docx在复制带自定义样式的段落时，仅仅复制段落和Run的表面格式是不够的，必须先把源文档的自定义样式完整导入到目标文档，否则样式关联的深层属性（比如你手动调的行距、段落间距）会丢失。下面分Python和C#两种方案给你解决思路：

Python 解决方案

首先，你之前的代码只创建了样式名称，但没有复制样式的实际格式属性（比如段落间距、字体设置），导致目标文档的新样式还是基于默认的Normal样式，自然和源文档不一致。我们需要先写一个函数，完整复制源样式的所有属性到目标文档，再复制段落内容和格式。

完整代码示例

from docx import Document
from docx.enum.style import WD_STYLE_TYPE
from docx.shared import Pt

def copy_style(source_style, target_styles):
    """将源文档的样式完整复制到目标文档"""
    # 如果样式已存在，直接返回目标样式
    if source_style.name in target_styles:
        return target_styles[source_style.name]
    
    # 创建对应类型的新样式
    new_style = target_styles.add_style(source_style.name, source_style.type)
    
    # 复制基础样式（递归处理继承的样式）
    if source_style.base_style:
        new_style.base_style = copy_style(source_style.base_style, target_styles)
    
    # 复制段落格式（仅针对段落样式）
    if source_style.type == WD_STYLE_TYPE.PARAGRAPH:
        src_para_format = source_style.paragraph_format
        tgt_para_format = new_style.paragraph_format
        
        tgt_para_format.alignment = src_para_format.alignment
        tgt_para_format.space_before = src_para_format.space_before
        tgt_para_format.space_after = src_para_format.space_after
        tgt_para_format.line_spacing_rule = src_para_format.line_spacing_rule
        tgt_para_format.line_spacing = src_para_format.line_spacing
        tgt_para_format.first_line_indent = src_para_format.first_line_indent
    
    # 复制字体格式（段落和字符样式通用）
    src_font = source_style.font
    tgt_font = new_style.font
    
    tgt_font.name = src_font.name
    tgt_font.size = src_font.size
    tgt_font.bold = src_font.bold
    tgt_font.italic = src_font.italic
    tgt_font.underline = src_font.underline
    tgt_font.color.rgb = src_font.color.rgb
    tgt_font.highlight_color = src_font.highlight_color
    tgt_font.shadow = src_font.shadow
    
    return new_style

def copy_paragraph(source_para, target_doc):
    """复制段落的所有内容、样式和手动调整的格式"""
    # 创建新段落并应用已导入的样式
    target_para = target_doc.add_paragraph()
    target_para.style = target_doc.styles[source_para.style.name]
    
    # 覆盖段落的手动调整格式（样式基础上的修改）
    src_para_format = source_para.paragraph_format
    tgt_para_format = target_para.paragraph_format
    
    tgt_para_format.alignment = src_para_format.alignment
    tgt_para_format.space_before = src_para_format.space_before
    tgt_para_format.space_after = src_para_format.space_after
    tgt_para_format.line_spacing_rule = src_para_format.line_spacing_rule
    tgt_para_format.line_spacing = src_para_format.line_spacing
    tgt_para_format.first_line_indent = src_para_format.first_line_indent
    
    # 复制每个Run的内容和格式
    for source_run in source_para.runs:
        target_run = target_para.add_run(source_run.text)
        
        # 应用Run的字符样式（如果不是默认样式）
        if source_run.style.name != 'Default Paragraph Font':
            target_run.style = target_doc.styles[source_run.style.name]
        
        # 覆盖Run的手动调整格式
        target_run.bold = source_run.bold
        target_run.italic = source_run.italic
        target_run.underline = source_run.underline
        target_run.font.name = source_run.font.name
        target_run.font.size = source_run.font.size
        target_run.font.color.rgb = source_run.font.color.rgb
        target_run.font.highlight_color = source_run.font.highlight_color
        target_run.font.shadow = source_run.shadow

# 主流程
source_doc = Document("test.docx")
target_doc = Document("target.docx")

# 先导入所有源文档的段落和字符样式
for style in source_doc.styles:
    if style.type in (WD_STYLE_TYPE.PARAGRAPH, WD_STYLE_TYPE.CHARACTER):
        copy_style(style, target_doc.styles)

# 复制所有段落
for para in source_doc.paragraphs:
    copy_paragraph(para, target_doc)

target_doc.save("target_final.docx")

关键说明

先导入样式：递归复制源样式的所有属性（包括继承的基础样式），确保目标文档的样式和源文档完全一致。
先应用样式，再覆盖手动格式：段落/Run可能在样式基础上手动调整了格式，所以要先应用样式，再覆盖这些自定义修改，保证所有格式都被保留。

C# 解决方案

如果Python的方案还是有细微的格式丢失，C#的OpenXML SDK是更可靠的选择——它直接操作Word的底层XML结构，复制样式和段落几乎不会丢失任何属性。

完整代码示例

首先需要安装NuGet包：DocumentFormat.OpenXml

using DocumentFormat.OpenXml.Packaging;
using DocumentFormat.OpenXml.Wordprocessing;
using System.Linq;

class WordParagraphCopier
{
    static void Main()
    {
        string sourceFilePath = "test.docx";
        string targetTemplatePath = "target.docx";
        string outputFilePath = "target_final.docx";

        // 先复制模板文件到输出路径，避免修改原目标文档
        System.IO.File.Copy(targetTemplatePath, outputFilePath, overwrite: true);

        using (WordprocessingDocument sourceDoc = WordprocessingDocument.Open(sourceFilePath, isEditable: false))
        using (WordprocessingDocument targetDoc = WordprocessingDocument.Open(outputFilePath, isEditable: true))
        {
            // 复制源文档的所有样式到目标文档
            CopyStylesToTarget(sourceDoc, targetDoc);

            // 获取源文档和目标文档的正文
            Body sourceBody = sourceDoc.MainDocumentPart.Document.Body;
            Body targetBody = targetDoc.MainDocumentPart.Document.Body;

            // 克隆并添加每个段落
            foreach (Paragraph sourcePara in sourceBody.Elements<Paragraph>())
            {
                Paragraph clonedPara = (Paragraph)sourcePara.CloneNode(deep: true);
                targetBody.Append(clonedPara);
            }

            // 保存修改
            targetDoc.MainDocumentPart.Document.Save();
        }
    }

    static void CopyStylesToTarget(WordprocessingDocument sourceDoc, WordprocessingDocument targetDoc)
    {
        StyleDefinitionsPart sourceStylesPart = sourceDoc.MainDocumentPart.StyleDefinitionsPart;
        StyleDefinitionsPart targetStylesPart = targetDoc.MainDocumentPart.StyleDefinitionsPart;

        // 遍历源文档的所有样式，目标没有的就添加
        foreach (Style sourceStyle in sourceStylesPart.Styles.Elements<Style>())
        {
            if (!targetStylesPart.Styles.Elements<Style>().Any(style => style.StyleId == sourceStyle.StyleId))
            {
                Style clonedStyle = (Style)sourceStyle.CloneNode(deep: true);
                targetStylesPart.Styles.Append(clonedStyle);
            }
        }

        targetStylesPart.Save();
    }
}