Python實(shí)現(xiàn)在PDF添加各種類型的注釋和標(biāo)注

更新時(shí)間：2026年04月03日 08:19:59 作者：用戶835629078051

在?PDF?文檔處理場(chǎng)景中,添加注釋是一項(xiàng)實(shí)用且常見的需求,本文將詳細(xì)介紹如何使用?Python?在?PDF?文檔中添加各種類型的注釋和標(biāo)注,文中的示例代碼講解詳細(xì),感興趣的小伙伴可以了解下

在 PDF 文檔處理場(chǎng)景中，添加注釋是一項(xiàng)實(shí)用且常見的需求。無論是文檔審閱、協(xié)作編輯還是內(nèi)容標(biāo)記，注釋功能都能幫助我們?cè)诓恍薷脑牡那闆r下添加說明、高亮重點(diǎn)或插入批注。本文將詳細(xì)介紹如何使用 Python 在 PDF 文檔中添加各種類型的注釋和標(biāo)注。

為什么需要為 PDF 添加注釋

手動(dòng)在 PDF 中添加注釋不僅效率低下，而且難以保持一致的格式。通過編程方式實(shí)現(xiàn)這一功能具有以下優(yōu)勢(shì)：

批量處理 - 一次性為多個(gè)文檔添加相同格式的注釋
精確控制 - 像素級(jí)定位注釋位置，確保與文檔內(nèi)容完美對(duì)應(yīng)
類型豐富 - 程序化創(chuàng)建高亮、下劃線、自由文本、圖章等多種注釋
樣式一致性 - 統(tǒng)一設(shè)置顏色、透明度、邊框等屬性，保持專業(yè)外觀

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

首先需要安裝支持 PDF 操作的 Python 庫。本文使用 Spire.PDF for Python，它提供了完整的 PDF 注釋 API。

pip install Spire.PDF

該庫支持多種注釋類型，包括文本標(biāo)記、自由文本、圖章、線條、附件等，能夠滿足各種文檔標(biāo)注需求。

核心注釋類型

Spire.PDF 支持豐富的注釋類型，每種類型都有其特定的應(yīng)用場(chǎng)景：

1. 自由文本注釋（Free Text Annotation）

自由文本注釋允許在 PDF 頁面上添加可編輯的文本框，適用于添加詳細(xì)說明或批注。

from spire.pdf import *

# 創(chuàng)建 PDF 文檔
doc = PdfDocument()
page = doc.Pages.Add()

# 定義注釋區(qū)域
rect = RectangleF(100.0, 200.0, 200.0, 50.0)

# 創(chuàng)建自由文本注釋
textAnnotation = PdfFreeTextAnnotation(rect)
textAnnotation.Text = "\n這是一條自由文本注釋"

# 設(shè)置字體和邊框
font = PdfTrueTypeFont("微軟雅黑", 12.0, PdfFontStyle.Regular, True)
textAnnotation.Font = font

# 設(shè)置邊框樣式
border = PdfAnnotationBorder(1.5)
textAnnotation.Border = border
textAnnotation.BorderColor = PdfRGBColor(Color.get_Blue())

# 設(shè)置線條末端樣式
textAnnotation.LineEndingStyle = PdfLineEndingStyle.Circle

# 設(shè)置背景顏色和透明度
textAnnotation.Color = PdfRGBColor(Color.get_LightBlue())
textAnnotation.Opacity = 0.8

# 添加到頁面
page.AnnotationsWidget.Add(textAnnotation)

# 保存文檔
doc.SaveToFile("FreeTextAnnotation.pdf")
doc.Close()

關(guān)鍵 API 說明：

PdfFreeTextAnnotation - 創(chuàng)建可編輯文本注釋，需要指定矩形區(qū)域
PdfAnnotationBorder - 定義邊框?qū)挾?，使注釋外觀更加清晰
PdfLineEndingStyle - 控制注釋邊框的末端樣式（圓形、箭頭、方形等）
Opacity - 設(shè)置透明度（0.0-1.0），0.0 完全透明，1.0 完全不透明

2. 文本標(biāo)記注釋（Text Markup Annotation）

文本標(biāo)記注釋用于高亮、下劃線或刪除線標(biāo)記特定文本，是文檔審閱中最常用的功能。

from spire.pdf import *

# 加載現(xiàn)有 PDF 文檔
doc = PdfDocument()
doc.LoadFromFile("template.pdf")
page = doc.Pages[0]

# 獲取要標(biāo)記的文本位置
font = PdfTrueTypeFont("微軟雅黑", 12.0, PdfFontStyle.Regular, True)
format = PdfStringFormat()

# 繪制提示文本
prompt = "需要高亮的文本："
page.Canvas.DrawString(prompt, font, PdfBrushes.get_DodgerBlue(), 0.0, 50.0)

# 計(jì)算目標(biāo)文本位置
x = font.MeasureString(prompt, format).Width
label = "這是一個(gè)重要段落"
page.Canvas.DrawString(label, font, PdfBrushes.get_OrangeRed(), x, 50.0)

# 創(chuàng)建高亮注釋
incorrectWordLocation = PointF(x, 50.0)
markupText = "重要內(nèi)容提醒"
annotation = PdfTextMarkupAnnotation(
    markupText, 
    "重要段落",
    RectangleF(x, 50.0, 100.0, 20.0), 
    font
)

# 設(shè)置高亮類型為高亮顯示
annotation.TextMarkupAnnotationType = PdfTextMarkupAnnotationType.Highlight

# 設(shè)置高亮顏色
annotation.TextMarkupColor = PdfRGBColor(Color.get_Yellow())

# 添加到頁面
page.AnnotationsWidget.Add(annotation)

# 保存文檔
doc.SaveToFile("TextMarkupAnnotation.pdf")
doc.Close()

支持的標(biāo)記類型：

Highlight - 高亮顯示，類似熒光筆效果
Underline - 添加下劃線
StrikeOut - 添加刪除線
Squiggly - 添加波浪線

3. 線條注釋（Line Annotation）

線條注釋用于在文檔中繪制帶箭頭的直線，適用于指示、連接或測(cè)量。

from spire.pdf import *

doc = PdfDocument()
page = doc.Pages.Add()

# 定義線條的起點(diǎn)和終點(diǎn)坐標(biāo) [x1, y1, x2, y2]
linePoints = [100, 400, 300, 400]

# 創(chuàng)建線條注釋
lineAnnotation = PdfLineAnnotation(linePoints, "尺寸標(biāo)注")

# 設(shè)置線條意圖（影響閱讀器的顯示方式）
lineAnnotation.LineIntent = PdfLineIntent.LineDimension

# 設(shè)置起點(diǎn)和終點(diǎn)的樣式
lineAnnotation.BeginLineStyle = PdfLineEndingStyle.ClosedArrow
lineAnnotation.EndLineStyle = PdfLineEndingStyle.Diamond

# 設(shè)置線條顏色和背景色
lineAnnotation.InnerLineColor = PdfRGBColor(Color.get_Green())
lineAnnotation.BackColor = PdfRGBColor(Color.get_Green())

# 設(shè)置邊框樣式
lineAnnotation.lineBorder.BorderStyle = PdfBorderStyle.Solid
lineAnnotation.lineBorder.BorderWidth = 2

# 添加到頁面
page.AnnotationsWidget.Add(lineAnnotation)

# 保存文檔
doc.SaveToFile("LineAnnotation.pdf")
doc.Close()

線條樣式選項(xiàng)：

PdfLineEndingStyle.None - 無線端裝飾
PdfLineEndingStyle.Butt - 平頭端點(diǎn)
PdfLineEndingStyle.ClosedArrow - 閉合箭頭
PdfLineEndingStyle.OpenArrow - 開放箭頭
PdfLineEndingStyle.Diamond - 菱形端點(diǎn)
PdfLineEndingStyle.Circle - 圓形端點(diǎn)

4. 圖章注釋（Rubber Stamp Annotation）

圖章注釋用于添加預(yù)定義或自定義的狀態(tài)標(biāo)記，如"已批準(zhǔn)"、"機(jī)密"、"草稿"等。

from spire.pdf import *
from datetime import datetime

# 加載 PDF 文檔
document = PdfDocument()
document.LoadFromFile("document.pdf")
page = document.Pages[0]

# 創(chuàng)建自定義圖章模板
template = PdfTemplate(150.0, 60.0)

# 設(shè)置字體和顏色
font1 = PdfTrueTypeFont("微軟雅黑", 14.0, PdfFontStyle.Bold, True)
brush = PdfSolidBrush(PdfRGBColor(Color.get_Red()))

# 繪制圓角矩形邊框
rectangle = RectangleF(PointF(5.0, 5.0), SizeF(140.0, 50.0))
path = PdfPath()
path.AddArc(rectangle.X, rectangle.Y, 10.0, 10.0, 180.0, 90.0)
path.AddArc(rectangle.X + rectangle.Width - 10.0, rectangle.Y, 10.0, 10.0, 270.0, 90.0)
path.AddArc(rectangle.X + rectangle.Width - 10.0, rectangle.Y + rectangle.Height - 10.0, 
            10.0, 10.0, 0.0, 90.0)
path.AddArc(rectangle.X, rectangle.Y + rectangle.Height - 10.0, 10.0, 10.0, 90.0, 90.0)
path.CloseFigure()
template.Graphics.DrawPath(PdfPen(brush, 2.0), path)

# 繪制圖章文本
stampText = "? 已批準(zhǔn)\n" + datetime.now().strftime("%Y-%m-%d")
template.Graphics.DrawString(stampText, font1, brush, PointF(10.0, 15.0))

# 創(chuàng)建圖章注釋
stamp = PdfRubberStampAnnotation(RectangleF(PointF(400.0, 50.0), SizeF(150.0, 60.0)))
appearance = PdfAppearance(stamp)
appearance.Normal = template
stamp.Appearance = appearance

# 設(shè)置元數(shù)據(jù)
stamp.Author = "審核人"
stamp.Subject = "文檔審批"
stamp.ModifiedDate = datetime.now()

# 添加到頁面
page.AnnotationsWidget.Add(stamp)

# 保存文檔
document.SaveToFile("StampAnnotation.pdf")
document.Close()

預(yù)定義圖章圖標(biāo)：

如果不想自定義圖章，可以使用內(nèi)置圖標(biāo)：

# 使用預(yù)定義的"草稿"圖章
stamp = PdfRubberStampAnnotation(
    RectangleF(100.0, 100.0, 100.0, 40.0), 
    "草稿狀態(tài)"
)
stamp.Icon = PdfRubberStampAnnotationIcon.Draft
stamp.Color = PdfRGBColor(Color.get_Plum())
page.AnnotationsWidget.Add(stamp)

常用預(yù)定義圖標(biāo)包括：

Draft - 草稿
Approved - 已批準(zhǔn)
Confidential - 機(jī)密
Final - 最終版
Experimental - 實(shí)驗(yàn)性

5. 彈出注釋（Popup Annotation）

彈出注釋通常與其他注釋配合使用，鼠標(biāo)懸停時(shí)顯示詳細(xì)信息。

from spire.pdf import *

doc = PdfDocument()
page = doc.Pages.Add()

# 先創(chuàng)建一個(gè)文本標(biāo)記
font = PdfTrueTypeFont("微軟雅黑", 12.0, PdfFontStyle.Regular, True)
page.Canvas.DrawString("將鼠標(biāo)懸停在注釋上查看備注", font, 
                       PdfBrushes.get_Black(), 50.0, 100.0)

# 創(chuàng)建彈出注釋
popupRect = RectangleF(PointF(100.0, 150.0), SizeF.Empty())
popupAnnotation = PdfPopupAnnotation(popupRect, "這是詳細(xì)的批注信息\n可以包含多行文本")

# 設(shè)置圖標(biāo)樣式
popupAnnotation.Icon = PdfPopupIcon.Paragraph

# 設(shè)置是否默認(rèn)展開
popupAnnotation.Open = True

# 設(shè)置顏色
popupAnnotation.Color = PdfRGBColor(Color.get_Yellow())

# 添加到頁面
page.AnnotationsWidget.Add(popupAnnotation)

# 保存文檔
doc.SaveToFile("PopupAnnotation.pdf")
doc.Close()

6. 多邊形和多段線注釋（Polygon & Polyline Annotation）

多邊形和多段線注釋用于創(chuàng)建自定義形狀的標(biāo)注區(qū)域。

from spire.pdf import *
from datetime import datetime

doc = PdfDocument()
page = doc.Pages.Add()

# 創(chuàng)建多邊形注釋（封閉形狀）
polygon = PdfPolygonAnnotation(
    page, 
    [PointF(100.0, 200.0), PointF(150.0, 180.0), PointF(200.0, 200.0), 
     PointF(180.0, 250.0), PointF(120.0, 250.0)]
)

# 設(shè)置多邊形屬性
polygon.Color = PdfRGBColor(Color.get_PaleVioletRed())
polygon.Text = "重點(diǎn)關(guān)注區(qū)域"
polygon.Author = "審稿人"
polygon.Subject = "區(qū)域標(biāo)記"
polygon.BorderEffect = PdfBorderEffect.BigCloud  # 云朵邊框效果
polygon.ModifiedDate = datetime.now()

# 添加到頁面
page.AnnotationsWidget.Add(polygon)

# 保存文檔
doc.SaveToFile("PolygonAnnotation.pdf")
doc.Close()

綜合示例：創(chuàng)建帶多種注釋的審閱文檔

在實(shí)際應(yīng)用中，通常會(huì)組合使用多種注釋類型。以下示例演示如何在一個(gè)文檔中添加多種注釋：

from spire.pdf import *
from datetime import datetime

# 創(chuàng)建文檔
doc = PdfDocument()
margin = PdfMargins()
margin.Top = 50
margin.Bottom = 50
margin.Left = 50
margin.Right = 50
page = doc.Pages.Add(PdfPageSize.A4(), margin)

# 添加標(biāo)題
titleFont = PdfTrueTypeFont("微軟雅黑", 16.0, PdfFontStyle.Bold, True)
page.Canvas.DrawString("文檔審閱示例", titleFont, 
                       PdfBrushes.get_Black(), 0.0, 30.0)

# 添加正文
contentFont = PdfTrueTypeFont("微軟雅黑", 12.0, PdfFontStyle.Regular, True)
content = "這是一段需要審閱的文本內(nèi)容。其中某些部分需要高亮顯示，某些部分需要添加批注。"
page.Canvas.DrawString(content, contentFont, 
                       PdfBrushes.get_Black(), 0.0, 80.0)

# 1. 添加自由文本注釋
freeTextRect = RectangleF(50.0, 150.0, 250.0, 60.0)
freeText = PdfFreeTextAnnotation(freeTextRect)
freeText.Text = "\n審閱意見：\n此處表述需要更加清晰明確"
freeText.Font = PdfTrueTypeFont("微軟雅黑", 12.0, PdfFontStyle.Regular, True)
freeText.Color = PdfRGBColor(Color.get_LightYellow())
freeText.Opacity = 0.9
page.AnnotationsWidget.Add(freeText)

# 2. 添加圖章注釋
stampTemplate = PdfTemplate(120.0, 50.0, True)
stampFont = PdfTrueTypeFont("微軟雅黑", 12.0, PdfFontStyle.Bold, True)
stampBrush = PdfSolidBrush(PdfRGBColor(Color.get_Red()))
stampTemplate.Graphics.DrawString("待修改", stampFont, stampBrush, PointF(10.0, 15.0))

stamp = PdfRubberStampAnnotation(RectangleF(PointF(350.0, 150.0), SizeF(120.0, 50.0)))
stampAppearance = PdfAppearance(stamp)
stampAppearance.Normal = stampTemplate
page.AnnotationsWidget.Add(stamp)

# 3. 添加線條注釋指向特定位置
linePoints = [320, 200, 350, 180]
lineAnnot = PdfLineAnnotation(linePoints, "參考此處")
lineAnnot.BeginLineStyle = PdfLineEndingStyle.Butt
lineAnnot.EndLineStyle = PdfLineEndingStyle.ClosedArrow
lineAnnot.InnerLineColor = PdfRGBColor(Color.get_Blue())
page.AnnotationsWidget.Add(lineAnnot)

# 保存文檔
doc.SaveToFile("ComprehensiveReview.pdf")
doc.Close()

生成結(jié)果預(yù)覽：

實(shí)用技巧

設(shè)置注釋的作者和時(shí)間戳

annotation = PdfFreeTextAnnotation(rect)
annotation.Author = "張三"  # 設(shè)置作者
annotation.CreationDate = datetime.now()  # 創(chuàng)建時(shí)間
annotation.ModifiedDate = datetime.now()  # 修改時(shí)間

控制注釋的顯示層級(jí)

# 設(shè)置注釋標(biāo)志
annotation.Flags = PdfAnnotationFlags.Locked  # 鎖定注釋，防止刪除
# 或使用其他標(biāo)志
# PdfAnnotationFlags.Hidden - 隱藏注釋
# PdfAnnotationFlags.NoView - 不顯示在視圖中
# PdfAnnotationFlags.ReadOnly - 只讀模式

提取頁面中的所有注釋

# 加載文檔并獲取注釋集合
doc = PdfDocument()
doc.LoadFromFile("annotated.pdf")
annotations = doc.Pages[0].AnnotationsWidget

# 遍歷所有注釋
if annotations.Count > 0:
    for i in range(annotations.Count):
        annotation = annotations.get_Item(i)
        
        # 根據(jù)類型處理不同注釋
        if isinstance(annotation, PdfFreeTextAnnotationWidget):
            print(f"自由文本：{annotation.Text}")
        elif isinstance(annotation, PdfTextMarkupAnnotationWidget):
            print(f"高亮文本：{annotation.Text}")
        
        print(f"作者：{annotation.Author}")
        print(f"修改日期：{annotation.ModifiedDate}")