在處理 PDF 時，向文檔中添加文字是非常常見的場景，比如自動生成報(bào)告、插入批注說明、填寫表單模板或添加版本標(biāo)記等。借助 Python 向 PDF 插入文本，可以大幅提升文檔處理的靈活性與自動化效率。

相比手動操作或依賴復(fù)雜工具，使用專業(yè)的 PDF 庫能讓你通過幾行代碼精準(zhǔn)地控制文本位置、樣式和內(nèi)容。E-iceblue旗下Spire系列產(chǎn)品，是文檔處理組件領(lǐng)域的佼佼者，支持國產(chǎn)化信創(chuàng)。本文將介紹，如何借助功能強(qiáng)大的 Spire.PDF for Python 庫，演示如何實(shí)現(xiàn)這些操作。

Spire.PDF for Python免費(fèi)試用下載 

加入Spire技術(shù)交流QQ群（125237868），與更多開發(fā)者一起提升文檔開發(fā)技能。

環(huán)境準(zhǔn)備：安裝 Python PDF 庫

開始前，請先安裝 Spire.PDF for Python：

pip install Spire.PDF

選擇 Spire.PDF 的理由：

• 無需安裝 Acrobat 或其他辦公軟件
• 支持精確控制文本樣式與位置
• 同時支持創(chuàng)建與修改 PDF
• 跨平臺兼容，適用于各種操作系統(tǒng)

創(chuàng)建新 PDF 并添加文字

如果你需要從零創(chuàng)建一個 PDF 文件并寫入文字，以下示例展示了如何在空白頁面中插入帶有自定義樣式的文本內(nèi)容。

示例：創(chuàng)建空白 PDF 并插入文字

from spire.pdf import PdfDocument, PdfTrueTypeFont, PdfFontStyle, PdfSolidBrush, PdfRGBColor, PointF, RectangleF, \
    PdfStringFormat, PdfTextAlignment, PdfVerticalAlignment

# 創(chuàng)建一個新的 PDF 文檔并添加一頁
pdf = PdfDocument()
page = pdf.Pages.Add()

# 要繪制的文本內(nèi)容（示例字符串）
text = ("本報(bào)告總結(jié)了 2025 年第一季度各類產(chǎn)品的銷售表現(xiàn)。"
        + "以下是按產(chǎn)品類別劃分的總銷售額明細(xì)，"
        + "隨后是各個地區(qū)的銷售對比分析。")

# 設(shè)置字體、畫刷和起始坐標(biāo)點(diǎn)
font = PdfTrueTypeFont("微軟雅黑", 14.0, PdfFontStyle.Regular, True)  # 使用 Arial 字體，14號，常規(guī)樣式，嵌入字體
brush = PdfSolidBrush(PdfRGBColor(0, 0, 0))  # 使用黑色實(shí)心畫刷
point = PointF(50.0, 100.0)  # 文本起始繪制坐標(biāo)（未被實(shí)際使用）

# 設(shè)置文本布局區(qū)域和格式
layoutArea = RectangleF(50.0, 50.0, page.GetClientSize().Width - 100.0, page.GetClientSize().Height)
# 從頁面距離左邊 50、高度 50 的位置開始繪制文本，寬度為頁面寬度減去兩側(cè)各 50 的邊距，高度為整頁高度

stringFormat = PdfStringFormat(PdfTextAlignment.Left, PdfVerticalAlignment.Top)
# 文本左對齊，垂直頂部對齊

# 在頁面上繪制文本
page.Canvas.DrawString(text, font, brush, layoutArea, stringFormat, False)

# 保存 PDF 文件并關(guān)閉文檔
pdf.SaveToFile("output/new.pdf")
pdf.Close()

要點(diǎn)說明：

• 使用 PdfTrueTypeFont() 加載系統(tǒng)字體，支持字體大小與樣式配置。
• 通過 PdfSolidBrush() 設(shè)置文本顏色，例如 (0, 0, 0) 表示黑色。
• 使用 RectangleF() 定義文本繪制區(qū)域，支持自動換行。
• 通過 PdfStringFormat() 控制文字對齊方式。
• 使用 DrawString() 在頁面指定位置繪制文字，不影響其他內(nèi)容。

生成的 PDF 文件：

提示： 若有多段文字或需手動換行，可調(diào)整 Y 坐標(biāo)或多次調(diào)用 DrawString() 分段插入。

向已有 PDF 添加文字

若你希望在現(xiàn)有 PDF 文檔中添加文字，可通過加載 PDF、定位頁面，并指定位置插入文本。

常見應(yīng)用場景：

• 添加注釋或說明
• 標(biāo)記文檔處理狀態(tài)（如“已審核”、“作廢”）
• 向模板中填入信息字段

示例：在已有 PDF 頁面中添加文字

from spire.pdf import PdfDocument, PdfFontStyle, PdfSolidBrush, PdfRGBColor, PointF, PdfCjkStandardFont, PdfCjkFontFamily

# 加載已有的 PDF 文檔
pdf = PdfDocument()
pdf.LoadFromFile("input.pdf")  # 從文件加載 PDF
page = pdf.Pages[0]  # 獲取第一頁

# 設(shè)置字體為 Times Roman，字號 12，加粗
font = PdfCjkStandardFont(PdfCjkFontFamily.MonotypeHeiMedium, 16.0, PdfFontStyle.Bold)

# 使用紅色畫刷
brush = PdfSolidBrush(PdfRGBColor(255, 0, 0))  # 紅色

# 設(shè)置文本繪制位置
location = PointF(150.0, 110.0)

# 在指定位置繪制文本
page.Canvas.DrawString("本文件已批準(zhǔn)。", font, brush, location)

# 保存修改后的 PDF 文件
pdf.SaveToFile("output/modified.pdf")
pdf.Close()

要點(diǎn)說明：

• LoadFromFile() 可加載本地 PDF 文檔
• 使用 pdf.Pages[index] 訪問頁面對象
• 添加的內(nèi)容以疊加形式呈現(xiàn)，不會修改原始內(nèi)容
• 文本位置由 PointF(x, y) 控制，坐標(biāo)單位為磅（point）

保存的 PDF 文件：

通過調(diào)整坐標(biāo)參數(shù)，即可靈活控制文本位置。

設(shè)置文本樣式、位置、透明度與旋轉(zhuǎn)

添加文本不僅僅是插入內(nèi)容，更重要的是其呈現(xiàn)方式。Spire.PDF 支持多種文本樣式控制，包括字體、顏色、對齊方式、透明度和旋轉(zhuǎn)角度，常用于水印或提示標(biāo)簽。

設(shè)置字體與顏色

# 創(chuàng)建 PdfTrueTypeFont（使用系統(tǒng)中的 Calibri 字體，16號，斜體，嵌入字體）
font = PdfTrueTypeFont("Calibri", 16.0, PdfFontStyle.Italic, True)

# 創(chuàng)建 PdfFont（使用內(nèi)置 Times Roman 字體，16號，斜體）
font = PdfFont(PdfFontFamily.TimesRoman, 16.0, PdfFontStyle.Italic)

# 創(chuàng)建 PdfBrush，用于設(shè)置文本繪制顏色
brush = PdfSolidBrush(PdfRGBColor(34, 139, 34))  # 森林綠（forest green）

PdfTrueTypeFont 支持將字體嵌入 PDF，確保在不同設(shè)備上顯示一致。如需減小文件體積，可使用系統(tǒng)字體（不嵌入）。

設(shè)置透明度與旋轉(zhuǎn)角度

# 保存當(dāng)前畫布狀態(tài)
state = page.Canvas.Save()

# 設(shè)置半透明效果（0.0 = 完全透明，1.0 = 完全不透明）
page.Canvas.SetTransparency(0.4)

# 將原點(diǎn)移動到頁面中心
page.Canvas.TranslateTransform(page.Size.Width / 2, page.Size.Height / 2)

# 將畫布逆時針旋轉(zhuǎn) 45 度
page.Canvas.RotateTransform(-45)

# 在新的原點(diǎn)位置繪制文本
page.Canvas.DrawString("草稿", font, brush, PointF(-50, -20))

透明度與旋轉(zhuǎn)角度的結(jié)合，常用于創(chuàng)建水印、對角標(biāo)記等視覺效果。

示例：添加居中斜體水印

from spire.pdf import PdfDocument, PdfTrueTypeFont, PdfFontStyle, PdfSolidBrush, PdfRGBColor, PointF
from spire.pdf.common import Color

# 加載已有的 PDF 文檔
pdf = PdfDocument()
pdf.LoadFromFile("input1.pdf")
page = pdf.Pages[0]

# 要添加的水印文字
text = "請勿外傳此文檔"  # 將 "Confidential" 翻譯為中文“機(jī)密”

# 創(chuàng)建字體（微軟雅黑，40號，加粗，嵌入字體）
font = PdfTrueTypeFont("微軟雅黑", 40.0, PdfFontStyle.Bold, True)

# 創(chuàng)建畫刷（深藍(lán)色）
brush = PdfSolidBrush(PdfRGBColor(Color.get_DarkBlue()))

# 測量文字尺寸以計(jì)算居中位置
size = font.MeasureString(text)
x = (page.Canvas.ClientSize.Width - size.Width) / 2
y = (page.Canvas.ClientSize.Height - size.Height) / 2

# 保存當(dāng)前畫布狀態(tài)
state = page.Canvas.Save()

# 設(shè)置透明度為 0.3（30% 不透明）
page.Canvas.SetTransparency(0.3)

# 將原點(diǎn)移動到文字中心
page.Canvas.TranslateTransform(x + size.Width / 2, y + size.Height / 2)

# 旋轉(zhuǎn)畫布 -45 度（逆時針）
page.Canvas.RotateTransform(-45.0)

# 在旋轉(zhuǎn)后的畫布中心繪制文字，使其居中顯示
page.Canvas.DrawString(text, font, brush, PointF(-size.Width / 2, -size.Height / 2))

# 恢復(fù)畫布狀態(tài)
page.Canvas.Restore(state)

# 保存包含水印的新 PDF 文件
pdf.SaveToFile("output/with_watermark.pdf")
pdf.Close()

常用于生成自動水印文字，如 “CONFIDENTIAL”、“COPY” 等，可靈活用于批量處理。

生成的 PDF 文件：

文件正在被其他程序占用，保存時可能遇到 PermissionError。

常見問題與跨平臺注意事項(xiàng)

在不同平臺或字體環(huán)境下添加文本時，可能會遇到如下問題。以下是一些常見問題及解決建議：

總結(jié)

通過 Spire.PDF for Python，你可以靈活地實(shí)現(xiàn) PDF 文檔的文字添加，無論是新建文檔、修改現(xiàn)有文件，還是批量處理。該庫提供豐富的樣式與位置控制選項(xiàng)，適用于自動化報(bào)告、水印標(biāo)注、模板填充等多種場景。

常見問題（FAQ）

如何用 Python 向 PDF 添加文字？

使用如 Spire.PDF 等庫，通過 DrawString() 方法添加文字，并可設(shè)置字體、顏色和位置等屬性。

能否向已有 PDF 添加文字？

當(dāng)然可以。加載 PDF 后通過頁面對象調(diào)用 DrawString() 添加內(nèi)容即可。

如何將文本文件內(nèi)容轉(zhuǎn)換成 PDF？

逐行讀取 TXT 文件內(nèi)容，結(jié)合 DrawString() 方法按需寫入 PDF 頁面。

可以批量向多個 PDF 添加相同的內(nèi)容嗎？

可以。遍歷文件目錄，對每個 PDF 分別加載并插入指定文字即可完成批量處理。

————————————————————————————————————————

關(guān)于慧都科技：

慧都科技是一家行業(yè)數(shù)字化解決方案公司，長期專注于軟件、油氣與制造行業(yè)。公司基于深入的業(yè)務(wù)理解與管理洞察，以系統(tǒng)化的業(yè)務(wù)建模驅(qū)動技術(shù)落地，幫助企業(yè)實(shí)現(xiàn)智能化運(yùn)營與長期競爭優(yōu)勢。在軟件工程領(lǐng)域，我們提供開發(fā)控件、研發(fā)管理、代碼開發(fā)、部署運(yùn)維等軟件開發(fā)全鏈路所需的產(chǎn)品，提供正版授權(quán)采購、技術(shù)選型、個性化維保等服務(wù)，幫助客戶實(shí)現(xiàn)技術(shù)合規(guī)、降本增效與風(fēng)險(xiǎn)可控。慧都科技E-iceblue的官方授權(quán)代理商，提供E-iceblue系列產(chǎn)品免費(fèi)試用，咨詢，正版銷售等于一體的專業(yè)化服務(wù)。E-iceblue旗下Spire系列產(chǎn)品是國產(chǎn)文檔處理領(lǐng)域的優(yōu)秀產(chǎn)品，支持國產(chǎn)化信創(chuàng)，幫助企業(yè)高效構(gòu)建文檔處理的應(yīng)用程序。

歡迎下載|體驗(yàn)更多E-iceblue產(chǎn)品