通過Python編程實現Word文檔中圖片的動態管理，可精準實現圖片的插入定位、條件化替換及冗餘元素刪除，尤其適用於需要定期生成標準化Word文檔。這種自動化方案不僅顯著降低人工操作導致的格式錯位、版本混亂等風險，還能通過API接口與數據庫、圖像處理系統無縫集成，為構建端到端的智能文檔生成體系奠定基礎。本文將介紹如何使用Python在Word文檔中添加、替換和刪除圖片。

• 用Python插入圖片到Word文檔
• 用Python替換Word文檔中的圖片為新的圖片
• 用Python替換Word文檔中的圖片為文本
• 用Python刪除Word文檔中的圖片

本文所使用的方法需要用到免費的Free Spire.Doc for Python，PyPI：pip install spire.doc。

用Python插入圖片到Word文檔

我們可以通過庫中提供的Paragraph.AppendPicture(string: fileName)方法從指定路徑插入圖片到Word文檔中的指定段落，並可使用DocPicture類下的屬性對圖像的大小、位置和文字環繞方式等進行設置。以下是操作步驟：

1. 導入所需模塊。
2. 創建Document對象，從而新建Word文檔。
3. 使用Document.AddSection()方法在文檔中添加節，並設置格式。
4. 使用Section.AddParagraph()方法在節中添加段落，使用Paragraph.AppendText()方法在段落中添加文本，並設置格式。
5. 使用Paragraph.AppendPicture()方法在段落中添加圖片。

6. 使用DocPicture類下的屬性設置圖片屬性：

   • 使用Width和Height屬性設置圖片大小。
   • 使用HorizontalPosition和VerticalPosition屬性設置圖片的位置。
   • 使用TextWrappingStyle屬性設置圖片的文字環繞方式。
7. 使用Document.SaveToFile()方法保存文檔。
8. 釋放資源。

代碼示例：

from spire.doc import Document, TextWrappingStyle, FileFormat

# 創建Document對象，從而新建Word文檔
doc = Document()

# 在文檔中添加一個節，並設置頁邊距
section = doc.AddSection()
section.PageSetup.Margins.All = 72

# 在節中添加段落，在段落中添加文本
para = section.AddParagraph()
textRange = para.AppendText("Document Introduction")
textRange.CharacterFormat.FontName = "Arial"
textRange.CharacterFormat.FontSize = 16
textRange.CharacterFormat.Bold = True

# 添加段落，並添加圖片到段落中
para1 = section.AddParagraph()
pic = para1.AppendPicture("Word.png")

# 設置圖片尺寸
pic.Width = 64
pic.Height = 64

# 設置圖片位置（可選）
pic.HorizontalPosition = 360
pic.VerticalPosition = 10

# 設置圖片文本環繞方式
pic.TextWrappingStyle = TextWrappingStyle.Square

# 添加文本並設置格式
textRange2 = para1.AppendText("This document serves as a structured repository of critical information, designed to facilitate clear communication, collaborative workflows, and long-term knowledge retention. Its architecture prioritizes accessibility, with a navigable hierarchy of headings, cross-referenced sections, and embedded metadata to streamline information retrieval.")
textRange2.CharacterFormat.FontName = "Arial"
textRange2.CharacterFormat.FontSize = 12

# 保存文檔
doc.SaveToFile("output/AddPicToWord.docx", FileFormat.Docx2019)
doc.Dispose()

結果文檔

用Python替換Word文檔中的圖片為新的圖片

我們可以通過判斷段落的各個子對象的DocumentObjectType屬性是否為DocumentObjectType.Picture來找出文檔中的所有圖片。然後，我們可以將圖片子對象轉換為DocPicture，再使用DocPicture.LoadImage()方法使用指定的圖片替換原圖片。替換後的圖片將保留原圖片的位置和文本環繞方式屬性，圖片大小可設置為原圖片的大小。以下是操作步驟：

1. 導入所需模塊。
2. 創建Document對象，使用Document.LoadFromFile()方法載入Word文檔。
3. 依次遍歷文檔中的節、節中的段落以及段落中的子對象，判斷每個子對象的DocumentObjectType屬性是否為DocumentObjectType.Picture，將判斷成功的對象添加到列表中。
4. 將圖片子對象轉換為DocPicture，再使用DocPicture.LoadImage()方法使用指定的圖片替換原圖片。
5. 使用Document.SaveToFile()方法保存文檔。
6. 釋放資源。

代碼示例：

from spire.doc import Document, DocumentObjectType, DocPicture

# 創建Document對象
doc = Document()

# 加載Word文檔
doc.LoadFromFile("output/AddPicToWord.docx")

# 創建一個列表來存儲圖片
pictures = []

# 遍歷文檔中的所有節
for i in range(doc.Sections.Count):
    sec = doc.Sections.get_Item(i)

    # 遍歷每一節中的所有段落
    for j in range(sec.Paragraphs.Count):
        para = sec.Paragraphs.get_Item(j)

        # 遍歷每個段落中的所有子對象
        for k in range(para.ChildObjects.Count):
            docObj = para.ChildObjects.get_Item(k)

            # 查找圖片並將其添加到列表中
            if docObj.DocumentObjectType == DocumentObjectType.Picture:
                pictures.append(docObj)

# 用新圖片替換列表中的第一張圖片
picture = DocPicture(pictures[0])
width = picture.Width
height = picture.Height
picture.LoadImage("NewWord.png")

# 修改圖片的尺寸
picture.Width = width
picture.Height = height

# 保存結果文檔
doc.SaveToFile("output/ReplaceWordImage.docx")
doc.Close()

結果文檔

用Python替換Word文檔中的圖片為文本

我們還可以在找出圖片子對象後，使用Paragraph.ChildObjects.Insert(Index, TextRange)方法在其位置插入文本，並使用Paragraph.ChildObjects.Remove()方法將圖片子對象刪除，從而實現圖片到文本的替換。以下是操作步驟：

1. 導入所需模塊。
2. 創建Document對象，使用Document.LoadFromFile()方法載入Word文檔。
3. 依次遍歷文檔中的節、節中的段落以及段落中的子對象，判斷每個子對象的DocumentObjectType屬性是否為DocumentObjectType.Picture，將判斷成功的對象添加到列表中。
4. 通過創建TextRange對象創建文本，設置文字及其格式。
5. 使用Paragraph.ChildObjects.IndexOf()方法獲取圖片子對象在段落中的索引。
6. 使用Paragraph.ChildObjects.Insert()方法將文本插入到段落中相應位置。
7. 使用Paragraph.ChildObjects.Remove()方法刪除圖片子對象。
8. 使用Document.SaveToFile()方法保存文檔。
9. 釋放資源。

代碼示例：

from spire.doc import Document, DocumentObjectType, TextRange, Color

# 創建Document對象
doc = Document()

# 加載Word文檔
doc.LoadFromFile("output/AddPicToWord.docx")

# 遍歷文檔中的所有節
for k in range(doc.Sections.Count):
    sec = doc.Sections.get_Item(k)

    # 遍歷每一節中的所有段落
    for m in range(sec.Paragraphs.Count):
        para = sec.Paragraphs.get_Item(m)

        # 創建一個列表來存儲圖片
        pictures = []

        # 查找圖片並將其添加到列表中
        for x in range(para.ChildObjects.Count):
            docObj = para.ChildObjects.get_Item(x)
            if docObj.DocumentObjectType == DocumentObjectType.Picture:
                pictures.append(docObj)

        # 遍歷列表中的所有圖片，並用文本替換它們
        for pic in pictures:
            # 獲取圖片的索引位置
            index = para.ChildObjects.IndexOf(pic)
            # 創建一個TextRange對象
            textRange = TextRange(doc)
            textRange.Text = "Word Document "
            textRange.CharacterFormat.FontName = "Arial"
            textRange.CharacterFormat.FontSize = 20
            textRange.CharacterFormat.TextColor = Color.get_Red()
            # 將文本插入到段落中
            para.ChildObjects.Insert(index, textRange)
            # 刪除圖片
            para.ChildObjects.Remove(pic)

# 保存結果文檔
doc.SaveToFile("output/ReplaceWordImageWithText.docx")
doc.Close()

結果文檔

用Python刪除Word文檔中的圖片

在找出文檔中的圖片子對象後，我們可以直接使用Paragraph.ChildObjects.Remove()方法刪除圖片子對象，從而刪除Word文檔中的圖片。以下是操作步驟：

1. 導入所需模塊。
2. 創建Document對象，使用Document.LoadFromFile()方法載入Word文檔。
3. 依次遍歷文檔中的節、節中的段落以及段落中的子對象，判斷每個子對象的DocumentObjectType屬性是否為DocumentObjectType.Picture，將判斷成功的對象添加到列表中。
4. 使用Paragraph.ChildObjects.IndexOf()方法獲取圖片子對象在段落中的索引。
5. 使用Paragraph.ChildObjects.Remove()方法刪除圖片子對象。
6. 使用Document.SaveToFile()方法保存文檔。
7. 釋放資源。

代碼示例：

from spire.doc import Document, DocumentObjectType, TextRange, Color

# 創建Document對象
doc = Document()

# 加載Word文檔
doc.LoadFromFile("output/AddPicToWord.docx")

# 遍歷文檔中的所有節
for k in range(doc.Sections.Count):
    sec = doc.Sections.get_Item(k)

    # 遍歷每一節中的所有段落
    for m in range(sec.Paragraphs.Count):
        para = sec.Paragraphs.get_Item(m)

        # 創建一個列表來存儲圖片
        pictures = []

        # 查找圖片並將其添加到列表中
        for x in range(para.ChildObjects.Count):
            docObj = para.ChildObjects.get_Item(x)
            if docObj.DocumentObjectType == DocumentObjectType.Picture:
                pictures.append(docObj)

        # 遍歷列表中的所有圖片，並用文本替換它們
        for pic in pictures:
            # 獲取圖片的索引位置
            index = para.ChildObjects.IndexOf(pic)
            # 刪除圖片子對象
            para.ChildObjects.Remove(pic)

# 保存結果文檔
doc.SaveToFile("output/RemoveWordImage.docx")
doc.Close()

結果文檔

本文演示瞭如何使用Python在Word文檔中添加、替換以及刪除圖片，提供步驟介紹和代碼示例。