Python处理PDF空白页：解决插入后页码混乱导致位置错误问题

问题原因 #

1. 初始生成的按钮绑定的是原文档的页码值，插入空白页后文档页码总数和顺序变化，但按钮未同步更新，导致后续点击时使用旧的页码参数插入。
2. 原代码中btnClick变量的逻辑错误，不仅重复插入空白页，还错误地手动调整插入位置，进一步加剧页码错位。
3. 页面列表UI未做动态更新，插入操作后用户看到的按钮仍对应原文档结构，与实际PDF文档页码不匹配。

解决方案 #

• 移除错误的btnClick逻辑，直接基于当前PDF文档的页码位置插入空白页。
• 实现页面UI的动态刷新：每次插入空白页后，重新生成所有页码按钮和标签，确保按钮绑定的是最新的页码。
• 优化插入逻辑：在指定页码i下方插入空白页，实际是在i+1的位置插入（因为PyMuPDF的new_page(pno=i)是在第i页之前插入，要在下方插入需设置pno=i+1）。

修改后的完整代码 #

import tkinter as tk
from tkinter import *
from tkinter import ttk
from tkinter import filedialog
from tkinter.filedialog import asksaveasfilename
import fitz

def launchInsert():
    global root
    global buttonframe
    global second_frame
    root = tk.Tk()
    root.title("Insert Blank Page")
    root.geometry("800x600")

    # 程序标题
    label = tk.Label(root, text="Insert Blank Page", font=('Arial',18))
    label.pack(padx=20, pady=20)

    # 文件浏览按钮框架
    buttonframe = tk.Frame(root, padx=100, pady=25)
    btn1 = tk.Button(buttonframe,text="Browse...", font=('Arial',18), command=browse_file)
    btn1.grid(row=1, column=6, padx=225, sticky=tk.W+tk.E)
    buttonframe.pack(side="bottom")

    # 初始化页面显示框架
    second_frame = None

def save_file():
    f = asksaveasfilename(initialfile='untitled.pdf',
                          defaultextension=".pdf",
                          filetype=[("PDF Files","*.pdf"),("All Files","*.*")])
    if f:
        pdf2.save(f)

def blank(i):
    # 在页码i的下方插入空白页，即i+1的位置（PyMuPDF new_page(pno)是在该页码前插入）
    pdf2.new_page(pno=i+1, width=595, height=842)
    # 刷新页面按钮列表
    refresh_page_buttons()
    print(f"空白页已插入到页码{i}下方")
    print(f"当前文档总页数: {len(pdf2)}")

def refresh_page_buttons():
    global second_frame
    # 清除旧的页面按钮和标签
    for widget in second_frame.winfo_children():
        widget.destroy()
    # 重新生成所有页码按钮和标签
    for i in range(len(pdf2)):
        tk.Button(second_frame, text=f'Insert\nbelow {i}', padx=50, 
                  command=lambda i=i: blank(i)).grid(row=i, column=5, pady=25, padx=50)
        tk.Label(second_frame, text=f"Page number {i}", padx=200).grid(row=i, column=1)
    # 更新画布滚动区域
    second_frame.update_idletasks()
    my_canvas.configure(scrollregion=my_canvas.bbox("all"))

def browse_file():
    global filename
    global pdf2
    global my_canvas
    global second_frame
    filename = filedialog.askopenfilename(title="Select a File", 
                                          filetype=(("PDF Files","*.pdf"),("All Files","*.*")))
    if not filename:
        return

    pdf2 = fitz.open(filename)
    
    # 创建主框架和画布
    main_frame = Frame(root)
    main_frame.pack(fill=BOTH, expand=1)

    my_canvas = Canvas(main_frame)
    my_canvas.pack(side=LEFT, fill=BOTH, expand=1)

    # 滚动条配置
    my_scrollbar = ttk.Scrollbar(main_frame, orient=VERTICAL, command=my_canvas.yview)
    my_scrollbar.pack(side=RIGHT, fill=Y)
    my_canvas.configure(yscrollcommand=my_scrollbar.set)
    my_canvas.bind('<Configure>', lambda e: my_canvas.configure(scrollregion = my_canvas.bbox("all")))

    # 页面显示框架
    second_frame = Frame(my_canvas)
    my_canvas.create_window((0,0), window=second_frame, anchor="nw")

    # 添加保存按钮
    btn2 = tk.Button(buttonframe,text="Save", font=('Arial',18), command=save_file)
    btn2.grid(row=1, column=7, pady=20, sticky=tk.W+tk.E)
    
    # 生成初始页码按钮
    refresh_page_buttons()

launchInsert()
mainloop()

关键修改点 #

• 新增refresh_page_buttons函数，负责清除旧UI组件并重新生成对应最新文档页码的按钮和标签。
• 修正插入逻辑：将pdf2.new_page(pno=i)改为pno=i+1，实现“在指定页码下方插入”的需求。
• 移除了错误的btnClick全局变量及相关逻辑，避免重复插入和位置错误。
• 优化了保存函数，增加了文件路径非空判断，防止空路径报错。

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