环境搭建

这篇文章使用 Spire.PDF for Python 库来操作 PDF 文档。不过，通过 pip 安装即可：

pip install Spire.PDF

安装完成后在脚本中导入所需模块：

from spire.pdf.common import *
from spire.pdf import *

创建带有父子层级的书签

PDF 文档可以包含多个顶级书签。每个父书签到下又可以挂载多个子书签到形成树状导航。怎么说呢，下面给出从基础开始创建一个简单示例的完整代码片段。

1️⃣ 建立基本页面布局

doc = PdfDocument
unitCvtr = PdfUnitConvertor
margin = PdfMargins
margin.Top = unitCvtr.ConvertUnits
margin.Bottom = margin.Top
margin.Left = unitCvtr.ConvertUnits
margin.Right = margin.Left
section = doc.Sections.Add
section.PageSettings.Margins = margin
section.PageSettings.Size = PdfPageSize.A4
# 创建第一页并绘制标题
page = section.Pages.Add
font_title = PdfTrueTypeFont
brush = PdfBrushes.get_Black
format_center = PdfStringFormat
page.Canvas.DrawString("PDF 书签示例文档",font_title,brush,page.Canvas.ClientSize.Width / 2,page.Canvas.ClientSize.Height / 10,format_center)

2️⃣ 添加父级书签并关联目标位置

font_chapter = PdfTrueTypeFont
y_chapter1 = page.Canvas.DrawString(". 第一章 概述",font_chapter,PdfBrushes.get_Blue,margin.Left,margin.Top + 50)
dest1 = PdfDestination)
bookmark1 = doc.Bookmarks.Add
bookmark1.Color = PdfRG娱乐olor)
bookmark1.DisplayStyle = PdfTextStyle.BoldBookmark
bookmark1.Action = PdfGoToAction

3️⃣ 添加子级书签并放置于父级之下

childCollection = PdfBookmarkCollection
# 新增第二页作为子章节内容页
page2 = section.Pages.Add
y_chapter2_0 = page2.Canvas.DrawString(". 背景介绍",font_chapter,PdfBrushes.get_Brown,margin.Left。margin.Top + 30)
dest_child0 = PdfDestination)
child_bookmark0 = childCollection.Add
child_bookmark0.Color = PdfRG娱乐olor)
child_bookmark0.DisplayStyle =PdfTextStyle.ItalicBold
child_bookmark0.Action =PdfGoToAction

4️⃣ 保存文件

doc.SaveToFile
doc.Close

修改已有书签

If you already have a PDF with bookmarks and want to tweak m automatically:

doc=PdfDocument
doc.LoadFromFile
# 修改第一个顶级书签到标题与颜色
top_bm=doc.Bookmarks
top_bm.Title= "已更新标题"
top_bm.Color=PdfRG娱乐olor)
top_bm.DisplayStyle=PdfTextStyle.Bold
# 对所有子级递归修改颜色与样式
def update_children:
coll=PdfBookmarkCollection
for i in range:
child=coll
child.Color=PdfRG娱乐olor)
child.DisplayStyle=PdfTextStyle.Regular
update_children
update_children
doc.SaveToFile
doc.Close

删除单个或全部 book‑marks

删除指定顶级 book‑mark

doc=PdfDocument
doc.LoadFromFile
# 删除第一个顶级book‑mark
doc.Bookmarks.RemoveAt
doc.SaveToFile
doc.Close

清除所有 book‑marks

doc=PdfDocument
doc.LoadFromFile
# 一键清空整个集合，适用于重构前先做清理
doc.Bookmarks.Clear
doc.SaveToFile
doc.Close

获取 book‑mark 信息

1. 获取标题与样式:

python doc=PdfDocument doc.LoadFromFile results= if doc.Bookmarks.Count>0: results.append for i in range: parent= doc.Bookmarks results.append results.append # 子集递归打印 children=P d Bookmark Collection for j in range: child=children results.append results.append with open as f: f.write) doc.Close

python doc  ＝  Ｐｒｙ Ｄｏｃ ＇input​.pdf’ bookmark ＝  Ｐｒｙ ＢｏｏＫｍｅｎｅ ｕＢａｍ．BooＭeN［０］＇ page_number ＝ ＰＲＴＡＭＡＮ．ＰＡＧＥＳ．ＩＮＤＥＸＯＦ+１ print doc.Close

📌 小结： - 利用代码一次性把多份文件中的book‑mark全部清除，再按需添加新结构，- 凭借正则匹配可以把原始文本中的章节名一键提取出来而且根据模板直接生成对应层次；- 在报表生成流水线里加上这一段就可以“无缝导向”的效果。

请将上述代码复制粘贴至 .py 文件，接下来按需执行。若对 Spire.PDF 的 API 不熟悉。可查阅官方文档进一步自定义属性，如缩放比例、图标等。祝你编写顺利，PDF 导航更友好！🌟🚀