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

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

Spire.PDF for Python免費試用下載 

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

環境準備：安裝 Python PDF 庫

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

pip install Spire.PDF

選擇 Spire.PDF 的理由：

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

創建新 PDF 并添加文字

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

示例：創建空白 PDF 并插入文字

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

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

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

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

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

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

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

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

要點說明：

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

生成的 PDF 文件：

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

向已有 PDF 添加文字

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

常見應用場景：

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

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

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

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

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

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

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

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

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

要點說明：

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

保存的 PDF 文件：

通過調整坐標參數，即可靈活控制文本位置。

設置文本樣式、位置、透明度與旋轉

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

設置字體與顏色

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

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

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

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

設置透明度與旋轉角度

# 保存當前畫布狀態
state = page.Canvas.Save()

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

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

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

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

透明度與旋轉角度的結合，常用于創建水印、對角標記等視覺效果。

示例：添加居中斜體水印

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" 翻譯為中文“機密”

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

# 創建畫刷（深藍色）
brush = PdfSolidBrush(PdfRGBColor(Color.get_DarkBlue()))

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

# 保存當前畫布狀態
state = page.Canvas.Save()

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

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

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

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

# 恢復畫布狀態
page.Canvas.Restore(state)

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

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

生成的 PDF 文件：

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

常見問題與跨平臺注意事項

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

總結

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

常見問題（FAQ）

如何用 Python 向 PDF 添加文字？

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

能否向已有 PDF 添加文字？

當然可以。加載 PDF 后通過頁面對象調用 DrawString() ;添加內容即可。

如何將文本文件內容轉換成 PDF？

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

可以批量向多個 PDF 添加相同的內容嗎？

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

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

關于慧都科技：

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

歡迎下載|體驗更多E-iceblue產品