PDF 文档的版式特性使其适用于输出不可变格式的报告与合同。但若要在此类文档中插入或修改文本，常规方式难以实现。借助Python，我们可以高效地向 PDF 添加文本，实现从文档生成到内容审阅的自动化流程。
本文将从技术角度详细讲解三种 PDF 文本添加方式：
- ✅ 新建 PDF 文档并添加段落文本；
- ✅ 向现有 PDF 文件插入简短说明或批注；
- ✅ 自定义文本格式、对齐方式与排版区域。
本文使用的方法需要用到免费的Free Spire.PDF for Python，可通过pip安装：
pip install spire.pdf.free新建PDF并添加段落文本
在构建系统报告或生成模板文档时，通常需要从空白页插入一段段文本，保持排版一致性。
from spire.pdf import PdfDocument, PdfTrueTypeFont, PdfFontStyle, PdfSolidBrush, PdfRGBColor, PointF, RectangleF, \
PdfStringFormat, PdfTextAlignment, PdfVerticalAlignment
# 创建新的PDF文档并添加页面
pdf = PdfDocument()
page = pdf.Pages.Add()
# 待插入的文本内容
text = ("The purpose of this document is to provide an overview of the company’s financial highlights for the fiscal year 2024. "
"It includes revenue trends, operational costs, and net income summaries. "
"The following sections will outline each metric in more detail.")
# 设置字体、画刷（颜色）和排版区域
font = PdfTrueTypeFont("Arial", 14.0, PdfFontStyle.Regular, True)
brush = PdfSolidBrush(PdfRGBColor(0, 0, 0)) # 黑色文本
layout_area = RectangleF(50.0, 50.0, page.GetClientSize().Width - 100.0, page.GetClientSize().Height)
string_format = PdfStringFormat(PdfTextAlignment.Left, PdfVerticalAlignment.Top)
# 添加文字内容
page.Canvas.DrawString(text, font, brush, layout_area, string_format, False)
# 保存并关闭
pdf.SaveToFile("output/new.pdf")
pdf.Close()技术细节说明：
PdfTrueTypeFont可嵌入外部字体文件，适用于需要控制字体兼容性的场景；RectangleF定义文本区域边界（支持自定义段落框）；DrawString()支持超出区域自动换行；- 使用
PdfStringFormat设定水平方向与垂直方向的对齐方式。
生成的PDF文档：
向现有PDF中插入文本内容
当你已有一份PDF文件，但希望在某一页添加标记或文字说明，例如审批标语、状态说明等，可以使用如下方式：
from spire.pdf import PdfDocument, PdfFontStyle, PdfSolidBrush, PdfRGBColor, PointF, PdfFont, PdfFontFamily
# 加载已有PDF文档
pdf = PdfDocument()
pdf.LoadFromFile("PDF.pdf")
page = pdf.Pages[0]
# 设置字体、颜色和插入位置
font = PdfFont(PdfFontFamily.TimesRoman, 12.0, PdfFontStyle.Bold)
brush = PdfSolidBrush(PdfRGBColor(0, 128, 0)) # 深绿色
location = PointF(130.0, 90.0)
# 插入文本
page.Canvas.DrawString("Verified by QA Department", font, brush, location)
# 保存结果
pdf.SaveToFile("output/ModifiedPDF.pdf")
pdf.Close()技术细节说明：
PdfFontFamily.TimesRoman属于 PDF 标准内置字体（无需嵌入）；- 坐标
PointF(x, y)单位为磅（1 pt ≈ 0.3528 mm），以页面左上角为 (0,0)； - 无需设置区域框时，适用于短文本、标签插入、动态盖章等场景。
修改的PDF文档：
复杂格式设置：添加透明旋转水印文本
在文档审阅或内部版本发布场景中，常见的做法是添加一个带透明度与旋转角度的水印文字，以提示机密性或防止误传播。Spire.PDF 提供了画布状态保存、旋转、透明度控制等接口，可用于实现这种复杂的格式需求。
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 = "Internal Use Only"
# 设置字体样式与大小
font = PdfTrueTypeFont("Arial", 40.0, PdfFontStyle.Bold, True)
# 设置画刷颜色为深红色
brush = PdfSolidBrush(PdfRGBColor(Color.get_DarkRed()))
# 测量文本大小以便居中放置
size = font.MeasureString(text)
x = (page.Canvas.ClientSize.Width - size.Width) / 2
y = (page.Canvas.ClientSize.Height - size.Height) / 2
# 保存当前画布状态
state = page.Canvas.Save()
# 设置透明度
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.SaveToFile("output/with_watermark.pdf")
pdf.Close()技术细节说明：
- 使用
SetTransparency(0.3)设置文本透明度，增强水印效果但不遮挡内容； TranslateTransform()将画布原点移动至文本中心；RotateTransform(-45)实现对角线旋转，常用于“CONFIDENTIAL”或“DRAFT”类水印；- 水印文本使用
DrawString()绘制，PointF(-size.Width / 2, -size.Height / 2)保证以中心为参考点； - 通过
Canvas.Save()与Canvas.Restore()管理局部画布状态，避免影响页面中其他元素。
修改后的PDF文档：
总结
通过 Spire.PDF for Python，你可以使用简洁的 Python 代码在 PDF 中添加各类文本，功能包括：
| 功能项 | 方法与说明 |
|---|---|
| ✅ 从零创建文档 | PdfDocument.Pages.Add() + DrawString() |
| ✅ 插入文本到现有文档 | LoadFromFile() + PointF 定位文本插入点 |
| ✅ 控制排版样式 | 使用 RectangleF + PdfStringFormat 控制对齐与区域 |
| ✅ 多行文本支持 | 文本中添加 \n，自动换行渲染 |
| ✅ 字体与颜色控制 | 支持 TrueType 与 标准字体，自定义颜色 RGB |
这三种方式覆盖了 PDF 文本添加的主要应用场景，从文档批量生成到人工标注支持，适合用于自动归档、审批流程、内容输出等业务场景。
更多PDF编辑教程，请访问：
Spire.PDF for Python 教程中心