如何用PyPDF2填充PDF并让文本显示在蓝色文本框上层

问题原因 #

PyPDF2仅更新表单字段的数值，但未自动生成字段的外观流（Appearance Stream）。虽然设置了/NeedAppearances让PDF阅读器尝试自动生成外观，但不同阅读器对该标记的支持不一致，导致填充的文本被输入框背景覆盖，仅点击时才显示。

方案1：优化PyPDF2代码，增强兼容性 #

在原有代码基础上，增加表单字段的外观属性配置，确保阅读器能正确渲染填充的文本：

修改后的代码：

#!/usr/bin/python3

filename = "file.pdf"

from PyPDF2 import PdfReader, PdfWriter
from PyPDF2.generic import BooleanObject, NameObject, IndirectObject, TextStringObject

def set_need_appearances(writer_or_reader):
    try:
        root = writer_or_reader._root_object if hasattr(writer_or_reader, "_root_object") else writer_or_reader.trailer["/Root"]
        if "/AcroForm" not in root:
            if hasattr(writer_or_reader, "_root_object"):
                root.update(
                    {
                        NameObject("/AcroForm"): IndirectObject(
                            len(writer_or_reader._objects), 0, writer_or_reader
                        )
                    }
                )
            else:
                root["/AcroForm"] = {}
        
        acro_form = root["/AcroForm"]
        acro_form[NameObject("/NeedAppearances")] = BooleanObject(True)
        # 设置默认文本外观，确保显示样式统一
        acro_form[NameObject("/DA")] = TextStringObject("/Helv 0 Tf 0 g")
        return writer_or_reader
    except Exception as e:
        print("set_need_appearances() error: ", repr(e))
        return writer_or_reader

# 读取PDF并配置表单属性
reader = PdfReader(filename)
set_need_appearances(reader)

blank_text_fields = reader.get_form_text_fields()
pdf_filler_dict = {}

for key in blank_text_fields.keys():
    if "BarCode" not in key:
        value = input(f"What is your {key[:-3]}? ")
        pdf_filler_dict[key] = value

# 初始化写入器并配置
writer = PdfWriter()
set_need_appearances(writer)
writer.add_page(reader.pages[0])

# 更新字段值并触发外观渲染
writer.update_page_form_field_values(
    writer.pages[0], 
    pdf_filler_dict,
    appearance_state="/Normal"
)

with open("filled-out.pdf", "wb") as output_stream:
    writer.write(output_stream)

方案2：改用PyMuPDF（fitz）库（更可靠） #

PyMuPDF会自动为填充的表单字段生成外观流，无需额外配置，显示效果与手动输入完全一致：

安装依赖 #

pip install pymupdf

实现代码 #

#!/usr/bin/python3

filename = "file.pdf"
import fitz  # PyMuPDF

# 打开PDF文档
doc = fitz.open(filename)
page = doc[0]

# 获取所有表单字段并收集填充值
fields = page.widgets()
pdf_filler_dict = {}

for field in fields:
    if field.field_type == fitz.PDF_WIDGET_TYPE_TEXT and "BarCode" not in field.field_name:
        value = input(f"What is your {field.field_name[:-3]}? ")
        pdf_filler_dict[field.field_name] = value

# 填充字段并更新外观
for field in fields:
    if field.field_name in pdf_filler_dict:
        field.field_value = pdf_filler_dict[field.field_name]
        field.update()

# 保存填充后的PDF
doc.save("filled-out.pdf")
doc.close()

效果说明 #

方案2的PyMuPDF实现无需依赖阅读器的/NeedAppearances支持，直接生成与手动输入一致的文本显示效果，兼容性更强。

内容的提问来源于stack exchange，提问作者Colin Lightfoot