使用Python處理Word文檔書簽

更新時(shí)間：2026年05月11日 08:40:41 作者：用戶835629078051

在處理長篇 Word 文檔時(shí),書簽（Bookmark）是一種非常有用的導(dǎo)航和定位工具,本文將介紹如何使用 Python 和 Spire.Doc for Python 庫在 Word 文檔中執(zhí)行各種書簽操作,感興趣的小伙伴可以了解下

在處理長篇 Word 文檔時(shí)，書簽（Bookmark）是一種非常有用的導(dǎo)航和定位工具。書簽允許開發(fā)者標(biāo)記文檔中的特定位置或內(nèi)容區(qū)域，從而實(shí)現(xiàn)快速訪問、內(nèi)容替換和動(dòng)態(tài)文檔生成等功能。

本文將介紹如何使用 Python 和 Spire.Doc for Python 庫在 Word 文檔中執(zhí)行各種書簽操作，包括創(chuàng)建書簽、提取書簽文本、替換書簽內(nèi)容、在書簽位置插入圖片和表格，以及刪除書簽等實(shí)用技術(shù)。

環(huán)境準(zhǔn)備

首先，需要安裝 Spire.Doc for Python 庫：

pip install Spire.Doc

安裝完成后，即可開始使用書簽相關(guān)的 API 進(jìn)行 Word 文檔處理。

什么是書簽及其應(yīng)用場景

書簽是 Word 文檔中的一種標(biāo)記機(jī)制，可以為文檔的特定位置或內(nèi)容區(qū)域命名。常見的應(yīng)用場景包括：

文檔導(dǎo)航：為重要章節(jié)或段落添加書簽，方便用戶快速跳轉(zhuǎn)
模板填充：在文檔模板中預(yù)設(shè)書簽，程序運(yùn)行時(shí)動(dòng)態(tài)替換為實(shí)際內(nèi)容
內(nèi)容提取：快速提取文檔中特定標(biāo)記區(qū)域的內(nèi)容
動(dòng)態(tài)文檔生成：根據(jù)業(yè)務(wù)需求在指定位置插入文本、圖片或表格

創(chuàng)建書簽

創(chuàng)建書簽是最基本的操作。在 Spire.Doc 中，可以通過 AppendBookmarkStart 和 AppendBookmarkEnd 方法來定義書簽的起始和結(jié)束位置。

以下示例演示如何創(chuàng)建簡單書簽和嵌套書簽：

from spire.doc import *
from spire.doc.common import *

def CreateBookmarkInDocument():
    # 創(chuàng)建 Word 文檔
    document = Document()
    
    # 添加新節(jié)
    section = document.AddSection()
    
    # 添加標(biāo)題段落
    paragraph = section.AddParagraph()
    txtRange = paragraph.AppendText("以下示例演示如何在 Word 文檔中創(chuàng)建書簽。")
    txtRange.CharacterFormat.Italic = True
    
    # 添加簡單書簽
    section.AddParagraph()
    paragraph = section.AddParagraph()
    txtRange = paragraph.AppendText("簡單書簽示例")
    txtRange.CharacterFormat.TextColor = Color.get_CornflowerBlue()
    paragraph.ApplyStyle(BuiltinStyle.Heading2)
    
    section.AddParagraph()
    paragraph = section.AddParagraph()
    paragraph.AppendBookmarkStart("SimpleBookmark")
    paragraph.AppendText("這是一個(gè)簡單書簽的內(nèi)容。")
    paragraph.AppendBookmarkEnd("SimpleBookmark")
    
    # 添加嵌套書簽
    section.AddParagraph()
    paragraph = section.AddParagraph()
    txtRange = paragraph.AppendText("嵌套書簽示例")
    txtRange.CharacterFormat.TextColor = Color.get_CornflowerBlue()
    paragraph.ApplyStyle(BuiltinStyle.Heading2)
    
    section.AddParagraph()
    paragraph = section.AddParagraph()
    paragraph.AppendBookmarkStart("Root")
    txtRange = paragraph.AppendText(" 根級(jí)別內(nèi)容 ")
    txtRange.CharacterFormat.Italic = True
    
    paragraph.AppendBookmarkStart("Level1")
    txtRange = paragraph.AppendText(" 第一級(jí)嵌套內(nèi)容 ")
    txtRange.CharacterFormat.Italic = True
    txtRange.CharacterFormat.TextColor = Color.get_DarkSlateGray()
    
    paragraph.AppendBookmarkStart("Level2")
    txtRange = paragraph.AppendText(" 第二級(jí)嵌套內(nèi)容 ")
    txtRange.CharacterFormat.Italic = True
    txtRange.CharacterFormat.TextColor = Color.get_DimGray()
    paragraph.AppendBookmarkEnd("Level2")
    
    paragraph.AppendBookmarkEnd("Level1")
    paragraph.AppendBookmarkEnd("Root")
    
    # 保存文檔
    document.SaveToFile("CreateBookmark.docx", FileFormat.Docx)
    document.Close()

CreateBookmarkInDocument()

結(jié)果文檔：

在上述代碼中，AppendBookmarkStart 和 AppendBookmarkEnd 方法成對(duì)使用，通過相同的書簽名稱來標(biāo)識(shí)書簽的范圍。嵌套書簽允許在一個(gè)書簽內(nèi)部包含其他書簽，形成層次結(jié)構(gòu)。

提取書簽文本

提取書簽內(nèi)容是一項(xiàng)常見需求，特別是在需要從大型文檔中獲取特定信息時(shí)?？梢允褂?BookmarksNavigator 類來定位并提取書簽內(nèi)容。

from spire.doc import *
from spire.doc.common import *

def ExtractBookmarkText():
    # 加載文檔
    doc = Document()
    doc.LoadFromFile("CreateBookmark.docx")
    
    # 創(chuàng)建書簽導(dǎo)航器實(shí)例
    navigator = BookmarksNavigator(doc)
    
    # 移動(dòng)到指定書簽
    navigator.MoveToBookmark("SimpleBookmark")
    
    # 獲取書簽內(nèi)容
    textBodyPart = navigator.GetBookmarkContent()
    
    # 遍歷書簽內(nèi)容項(xiàng)以提取文本
    text = ''
    for i in range(textBodyPart.BodyItems.Count):
        item = textBodyPart.BodyItems.get_Item(i)
        if isinstance(item, Paragraph):
            for j in range(item.ChildObjects.Count):
                childObject = item.ChildObjects.get_Item(j)
                if isinstance(childObject, TextRange):
                    text += childObject.Text
    
    print(f"提取的書簽文本：{text}")
    
    # 將文本寫入文件
    with open("ExtractedText.txt", "w", encoding="utf-8") as f:
        f.write(text)
    
    doc.Close()

ExtractBookmarkText()

BookmarksNavigator 類的 MoveToBookmark 方法用于定位到指定名稱的書簽，GetBookmarkContent 方法返回書簽的內(nèi)容對(duì)象。通過遍歷內(nèi)容對(duì)象中的子項(xiàng)，可以提取出純文本內(nèi)容。

替換書簽內(nèi)容

在實(shí)際應(yīng)用中，經(jīng)常需要用新內(nèi)容替換書簽位置的原有內(nèi)容。這在文檔模板填充場景中非常有用。

from spire.doc import *
from spire.doc.common import *

def ReplaceBookmarkContent():
    # 加載文檔
    doc = Document()
    doc.LoadFromFile("CreateBookmark.docx")
    
    # 定位到書簽
    bookmarkNavigator = BookmarksNavigator(doc)
    bookmarkNavigator.MoveToBookmark("SimpleBookmark")
    
    # 用新內(nèi)容替換書簽內(nèi)容
    bookmarkNavigator.ReplaceBookmarkContent("這是替換后的新內(nèi)容。", False)
    
    # 保存文檔
    doc.SaveToFile("ReplaceBookmarkContent.docx", FileFormat.Docx)
    doc.Close()

ReplaceBookmarkContent()

ReplaceBookmarkContent 方法的第一個(gè)參數(shù)是要替換的新內(nèi)容，第二個(gè)參數(shù)控制是否保留原有格式。設(shè)置為 False 表示不保留原有格式，使用新內(nèi)容的默認(rèn)格式。

在書簽位置插入圖片

除了文本替換，還可以在書簽位置插入圖片，這對(duì)于生成包含圖表或徽標(biāo)的文檔非常有用。

from spire.doc import *
from spire.doc.common import *

def InsertImageAtBookmark():
    # 加載文檔
    doc = Document()
    doc.LoadFromFile("CreateBookmark.docx")
    
    # 創(chuàng)建書簽導(dǎo)航器實(shí)例
    bn = BookmarksNavigator(doc)
    
    # 查找名為 "SimpleBookmark" 的書簽
    bn.MoveToBookmark("SimpleBookmark", True, True)
    
    # 添加臨時(shí)節(jié)和段落
    section0 = doc.AddSection()
    paragraph = section0.AddParagraph()
    
    # 在段落中添加圖片
    picture = paragraph.AppendPicture("./SampleImage.png")
    
    # 在書簽位置插入該段落
    bn.InsertParagraph(paragraph)
    
    # 移除臨時(shí)節(jié)
    doc.Sections.Remove(section0)
    
    # 保存文檔
    doc.SaveToFile("InsertImageAtBookmark.docx", FileFormat.Docx)
    doc.Close()

InsertImageAtBookmark()

此方法的核心思路是先創(chuàng)建一個(gè)包含圖片的段落，然后使用 InsertParagraph 方法將該段落插入到書簽位置。最后移除臨時(shí)創(chuàng)建的節(jié)，保持文檔結(jié)構(gòu)整潔。

在書簽位置插入表格

表格是 Word 文檔中常用的元素，可以在書簽位置動(dòng)態(tài)插入表格來展示結(jié)構(gòu)化數(shù)據(jù)。

from spire.doc import *
from spire.doc.common import *

def ReplaceBookmarkWithTable():
    # 加載文檔
    doc = Document()
    doc.LoadFromFile("CreateBookmark.docx")
    
    # 創(chuàng)建表格
    table = Table(doc, True)
    
    # 準(zhǔn)備表格數(shù)據(jù)
    rowsCount = 4
    colsCount = 5
    data = [
        ["姓名", "首都", "大洲", "面積", "人口"],
        ["阿根廷", "布宜諾斯艾利斯", "南美洲", "2777815", "32300003"],
        ["玻利維亞", "拉巴斯", "南美洲", "1098575", "7300000"],
        ["巴西", "巴西利亞", "南美洲", "8511196", "150400000"]
    ]
    
    # 重置表格單元格
    table.ResetCells(rowsCount, colsCount)
    
    # 填充表格數(shù)據(jù)
    for i in range(rowsCount):
        for j in range(colsCount):
            table.Rows[i].Cells[j].AddParagraph().AppendText(data[i][j])
    
    # 定位到書簽
    navigator = BookmarksNavigator(doc)
    navigator.MoveToBookmark("SimpleBookmark")
    
    # 創(chuàng)建 TextBodyPart 實(shí)例并添加表格
    part = TextBodyPart(doc)
    part.BodyItems.Add(table)
    
    # 用表格替換書簽內(nèi)容
    navigator.ReplaceBookmarkContent(part)
    
    # 保存文檔
    doc.SaveToFile("ReplaceWithTable.docx", FileFormat.Docx)
    doc.Close()

ReplaceBookmarkWithTable()

在這個(gè)示例中，首先創(chuàng)建一個(gè) Table 對(duì)象并填充數(shù)據(jù)，然后將表格添加到 TextBodyPart 對(duì)象中，最后使用 ReplaceBookmarkContent 方法將表格插入到書簽位置。這種方法可以靈活地插入各種復(fù)雜內(nèi)容。

刪除書簽

當(dāng)不再需要某個(gè)書簽時(shí)，可以將其從文檔中刪除。需要注意的是，刪除書簽不會(huì)刪除其包含的內(nèi)容，只會(huì)移除書簽標(biāo)記本身。

from spire.doc import *
from spire.doc.common import *

def RemoveBookmark():
    # 加載文檔
    document = Document()
    document.LoadFromFile("CreateBookmark.docx")
    
    # 通過名稱獲取書簽
    bookmark = document.Bookmarks["SimpleBookmark"]
    
    # 刪除書簽（保留內(nèi)容）
    document.Bookmarks.Remove(bookmark)
    
    # 保存文檔
    document.SaveToFile("RemoveBookmark.docx", FileFormat.Docx)
    document.Close()

RemoveBookmark()

如果需要同時(shí)刪除書簽及其內(nèi)容，可以先使用 ReplaceBookmarkContent 方法清空內(nèi)容，然后再刪除書簽標(biāo)記。

實(shí)用技巧

獲取文檔中的所有書簽

在處理未知結(jié)構(gòu)的文檔時(shí)，可能需要先獲取所有書簽的名稱列表：

from spire.doc import *

def GetAllBookmarks():
    doc = Document()
    doc.LoadFromFile("CreateBookmark.docx")
    
    # 遍歷所有書簽
    for bookmark in doc.Bookmarks:
        print(f"書簽名稱：{bookmark.Name}")
    
    doc.Close()

GetAllBookmarks()

檢查書簽是否存在

在操作書簽之前，最好先檢查書簽是否存在，以避免運(yùn)行時(shí)錯(cuò)誤：

def CheckBookmarkExists(doc, bookmarkName):
    for bookmark in doc.Bookmarks:
        if bookmark.Name == bookmarkName:
            return True
    return False

總結(jié)

本文介紹了使用 Python 和 Spire.Doc for Python 庫在 Word 文檔中進(jìn)行書簽操作的多種技術(shù)，包括：

創(chuàng)建簡單書簽和嵌套書簽
提取書簽中的文本內(nèi)容
替換書簽內(nèi)容為新的文本
在書簽位置插入圖片
在書簽位置插入表格
刪除書簽標(biāo)記

書簽功能為 Word 文檔自動(dòng)化處理提供了強(qiáng)大的支持，特別適用于文檔模板填充、動(dòng)態(tài)內(nèi)容生成和信息提取等場景。通過合理使用書簽，可以顯著提高文檔處理的效率和靈活性。

在實(shí)際開發(fā)中，可以根據(jù)具體需求組合使用這些操作，構(gòu)建更加復(fù)雜的文檔自動(dòng)化解決方案。例如，可以創(chuàng)建包含多個(gè)書簽的文檔模板，然后根據(jù)業(yè)務(wù)數(shù)據(jù)動(dòng)態(tài)填充各個(gè)書簽位置的內(nèi)容，實(shí)現(xiàn)批量文檔生成。

以上就是使用Python處理Word文檔書簽的詳細(xì)內(nèi)容，更多關(guān)于Python處理Word書簽的資料請關(guān)注腳本之家其它相關(guān)文章！

您可能感興趣的文章: