PyMuPDF如何向PDF表单域（Widget）写入内容？

你遇到的问题核心是错误使用了page.add_widget()——这个方法是用来添加新表单控件的，不是修改已有控件的。修改已有Widget的字段值后，只需要调用控件的update()方法，就能把修改同步到PDF文档里，不需要额外添加或删除控件。

修正后的代码 #

import fitz

doc = fitz.open('Loan01.pdf')
page = doc.load_page(0)  

# 加载目标表单控件
field = page.load_widget(724)  # pg_firstname
field.field_value = "Mary"  # 设置字段值
field.update()  # 提交修改到PDF文档

# 验证修改结果
for i, field in enumerate(page.widgets()):
    print(i, field.field_name, field.xref, field.field_value, '#')

# 保存修改后的PDF
doc.save('output01.pdf')

关键说明 #

• 不需要调用page.delete_widget()或page.add_widget()：已有控件的修改只需要通过field.update()同步，添加新控件会导致原有字段失效（就是你说的"dead"状态）。
• field.update()会把你设置的field_value写入到PDF的底层结构中，确保保存后能正确显示。
• 如果需要批量修改多个表单域，只需要遍历page.widgets()，找到对应字段后重复"设置值+update"的步骤即可。

内容的提问来源于stack exchange，提问作者Max Iskram