PyPDF2填充PDF表单字段：变量文本不显示的原因及解决思路

问题诊断 #

• 现象：调用update_page_form_field_values时，硬编码字符串能正常填充“Piece Weight”字段，但用字符串变量（含f-string）填充时字段为空。
• 本质原因：和PyPDF2无关，是Python变量作用域+tkinter按钮回调特性导致的问题：
  • 你全局初始化了variablestring = ""，但在按钮绑定的onStart函数里直接写variablestring = variableEntry.get()时，函数内的variablestring是新创建的局部变量，和全局变量完全是两个内存空间——全局变量根本没被更新。
  • tkinter的Button通过command自动调用函数时，无法直接传递参数，导致你想用输入框值更新全局变量的逻辑彻底失效。

解决方法 #

方法1：用global关键字绑定全局变量 #

在onStart函数里明确声明要使用全局的variablestring，这样赋值时才会修改全局变量，而不是创建局部变量：

variablestring = ""

def onStart():
    global variablestring  # 声明使用全局变量
    variablestring = variableEntry.get()
    # 执行PyPDF2填充逻辑
    reader = PyPDF2.PdfReader("input.pdf")
    writer = PyPDF2.PdfWriter()
    page = reader.pages[0]
    writer.add_page(page)
    writer.update_page_form_field_values(
        writer.pages[0],
        {"Piece Weight": variablestring}
    )
    with open("output.pdf", "wb") as output_file:
        writer.write(output_file)

# tkinter按钮绑定
tk.Button(root, text="开始填充", command=onStart).pack()

方法2：用类封装（更推荐，避免全局变量） #

把变量和逻辑封装到类里，用实例属性代替全局变量，从根源上规避作用域问题：

import tkinter as tk
import PyPDF2

class PdfFormFiller:
    def __init__(self, root):
        self.root = root
        self.variableEntry = tk.Entry(root)
        self.variableEntry.pack()
        tk.Button(root, text="开始填充", command=self.onStart).pack()
    
    def onStart(self):
        # 直接读取输入框值并使用
        input_value = self.variableEntry.get()
        # PyPDF2填充逻辑
        reader = PyPDF2.PdfReader("input.pdf")
        writer = PyPDF2.PdfWriter()
        page = reader.pages[0]
        writer.add_page(page)
        writer.update_page_form_field_values(
            writer.pages[0],
            {"Piece Weight": input_value}
        )
        with open("output.pdf", "wb") as output_file:
            writer.write(output_file)

if __name__ == "__main__":
    root = tk.Tk()
    app = PdfFormFiller(root)
    root.mainloop()

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