如何解决Python Tkinter独立GUI模块弹窗阻塞主程序的问题？

我正在开发一款用于施工放样的Python应用，负责管理点位数据，支持点位查询与计算。其中一个功能是通过独立模块从文本文件导入点位：如果检测到已存在重复点位，需要弹窗提示用户输入新的唯一点位名称，且用户未输入有效名称时要持续提示。

目前程序能正常处理第一个重复点位，但第二个重复点位的弹窗必须关闭主窗口才会显示，我排查了很久没找到原因，求技术帮助和优化建议。

主GUI代码 #

import tkinter as tk
import point_importer
import csv
from tkinter import Toplevel, ttk, TOP, BOTTOM
from tkinter import filedialog as fd
from point_importer import import_points 
from datetime import datetime
import tkinter.font as font
import pickle


filename = ''
current_azimuth = 0
point_dict = {}

class App(tk.Tk):
    def __init__(self):

        super().__init__()
        self.title('Survey Amateur')
        self.state('zoomed')
        self.resizable(False, False)

        self.columnconfigure((0,1), weight=1, uniform='column')
        self.rowconfigure(2, weight=0)

        self.main_buttons()
    
    def clear_window(self):
        for widget in self.winfo_children():
            widget.destroy()

    def main_buttons(self):
        self.clear_window()

        label_text = ttk.Label(self, text='Survey Amateur', font = ('helvetica', 44))
        label_text.grid(column=0, row=0, padx=10, pady=50, ipadx=0, columnspan=2)

        file_button = tk.Button(self, text='File', font = ('helvetica', 30), bg='grey82')
        file_button['command'] = self.file_window
        file_button.grid(column=0, row=2, padx=10, pady=50, ipadx=98, sticky='N')

        setting_button = tk.Button(self, text='Settings', font=('helvetica', 30), bg='grey82')
        setting_button.grid(column=1, row=2, padx=10, pady=50, ipadx=48, sticky='N')

        backsite_button = tk.Button(self, text='Set Backsite', font=('helvetica', 30), bg='grey82')
        backsite_button['command'] = self.backsite_window
        backsite_button.grid(column=0, row=3, padx=10, pady=50, sticky='N')

        stakeout_button = tk.Button(self, text='Stakeout', font=('helvetica', 30), bg='grey82')
        stakeout_button.grid(column=1, row=3, padx=10, pady=50, ipadx=40, sticky='N')

        empty_label = ttk.Label(self, text='', font='helvetica36')
        empty_label.grid(column=0, row=4, columnspan=2)
    
    def file_window(self):
        self.clear_window()

        label_text = ttk.Label(self, text='File', font=('helvetica', 44))
        label_text.grid(column=0, row=0, padx=10, pady=50, ipadx=0, columnspan=2)

        back_button = tk.Button(self, text='Back', font=('helvetica', 10))
        back_button['command'] = self.main_buttons
        back_button.grid(column=0, row=1, padx=10, pady=50, ipadx=0, sticky='N')

        open_button = tk.Button(self, text='Open', font=('helvetica', 30), bg='grey82')
        open_button['command'] = self.open_file
        open_button.grid(column=1, row=2, padx=10, pady=50, ipadx=0, sticky='N')

        new_button = tk.Button(self, text='New', font=('helvetica', 30), bg='grey82')
        new_button['command'] = self.new_file
        new_button.grid(column=0, row=2, padx=10, pady=50, sticky='N')

        export_button = tk.Button(self, text='Export', font=('helvetica', 30), bg='grey82')
        export_button.grid(column=1, row=3, padx=10, pady=50, sticky='N')

        import_button = tk.Button(self, text='Import', font=('helvetica', 30), bg='grey82')
        import_button['command'] = self.import_points
        import_button.grid(column=0, row=3, padx=10, pady=50, ipadx=0, sticky='N')

        empty_label = ttk.Label(self, text='', font='helvetica36')
        empty_label.grid(column=0, row=5, columnspan=2)

    def backsite_window(self):
        occupy_point = ''
        foresite_point = ''

        self.clear_window()

        label_text = ttk.Label(self, text='Set Backsite', font=('helvetica', 44))
        label_text.grid(column=0, row=0, padx=10, pady=50, ipadx=0, columnspan=2)

        Occupy_point_entry = ttk.Entry(self, textvariable=occupy_point, text='Back', font=('helvetica', 10))
        Occupy_point_entry.grid(column=0, row=1, padx=10, pady=50, ipadx=0, sticky='N')

        foresite_point_entry = ttk.Entry(self, textvariable=foresite_point, text='Open', font=('helvetica', 30), bg='grey82')
        foresite_point_entry.grid(column=1, row=1, padx=10, pady=50, ipadx=0, sticky='N')

        ts_height_entry = ttk.Entry(self, text='New', font=('helvetica', 30), bg='grey82')
        ts_height_entry.grid(column=0, row=2, padx=10, pady=50, sticky='N')

        rod_height_entry = ttk.Entry(self, text='New', font=('helvetica', 30), bg='grey82')
        rod_height_entry.grid(column=1, row=2, padx=10, pady=50, sticky='N')

        empty_label = ttk.Label(self, text='', font='helvetica36')
        empty_label.grid(column=0, row=5, columnspan=2)

    def open_file(self):
        global filename 
        filename = fd.askopenfilename(
            initialdir=r'C:\Users\Tim\Desktop\Code\Python\Surveying_Program',
            title='Browse',
            filetype = (('text files', '*.txt'), ("all files","*.*"))
        )

    def save_file(self):
        with open(filename, 'wb') as f:
            pickle.dump(point_dict, f)
    
    def new_file(self):
        global filename 
        filename = fd.asksaveasfilename(
            initialdir=r'C:\Users\Tim\Desktop\Code\Python\Surveying_Program',
            title = 'Save As',
            filetype = (('text files', '*.txt'), ("all files","*.*"))
        )
        open(filename + '.txt', 'w')
        self.save_file()

    def import_points(self):
        global point_dict
        import_file = fd.asksaveasfilename(
            initialdir=r'C:\Users\Tim\Desktop\Code\Python\Surveying_Program',
            title = 'Import File',
            filetype = (('text files', '*.txt'), ("all files","*.*"))
        )

        point_dict = point_importer.import_points(import_file, point_dict)
        print(point_dict)
        self.save_file()


if __name__ == "__main__":
    
    app = App()
    app.mainloop()

点位导入模块代码 #

import tkinter as tk
import csv
from datetime import datetime
from tkinter import BOTTOM, TOP, ttk


def get_new_point_name(old_point_name):
    global entry_box
    global root
    
    root = tk.Tk()
    root.title('Error')
    window_width = 600
    window_height = 300
    screen_width = root.winfo_screenwidth()
    screen_height = root.winfo_screenheight()
    center_x = int(screen_width/2 - window_width / 2)
    center_y = int(screen_height/2 - window_height / 2)
    root.geometry(f'{window_width}x{window_height}+{center_x}+{center_y}')

    label_text = f'There is already a point with the name {old_point_name}. Please enter a new point name:'
    new_point_label = tk.Label(root, text=label_text, font = ('helvetica', 10))
    new_point_label.grid(row=0, column=0, ipadx=10, ipady=10)
    
    entry_box = tk.Entry(root)
    entry_box.grid(row=1, column=0, ipadx=10, ipady=10)

    enter_button = tk.Button(root, text='Enter', command=get_entry)
    enter_button.grid(row=2, column=0, ipadx=10, ipady=10)

    root.mainloop()

def get_entry():
    global new_point_name
    new_point_name = entry_box.get()
    if new_point_name in my_dict.keys():
        #root.destroy()
        get_new_point_name(new_point_name)
    else:
        root.destroy()
        return new_point_name

def import_points(file_location, point_dict):
    global my_dict
    my_dict = point_dict
    now = datetime.now()
    with open(file_location, newline='') as csv_file:
        csv_reader = csv.reader(csv_file, delimiter=',')
        point_list = list(csv_reader)
        for item in point_list:
            if item[0] in point_dict.keys():
                get_new_point_name(item[0])
                print(new_point_name)
                item[0] = new_point_name

            point_info_dict = {}
            point_info_dict['northing'] = float(item[1])
            point_info_dict['easting'] = float(item[2])
            point_info_dict['elevation'] = float(item[3])
            point_info_dict['description'] = item[4]
            point_info_dict['time'] = now.strftime('%H:%M:%S')
            point_info_dict['date'] = now.strftime('%m/%d/%Y')

            point_dict[item[0]] = point_info_dict
    return point_dict 

问题原因与修复方案 #

问题原因 #

1. 多主窗口冲突：get_new_point_name中每次创建新的tk.Tk()实例，Tkinter应用只能有一个主窗口，多个实例会导致事件循环混乱，第二个弹窗被主窗口阻塞。
2. 全局变量滥用：new_point_name、root等全局变量在多次调用时状态残留，引发逻辑异常。
3. 递归弹窗未清理：get_entry递归调用时未销毁当前窗口，堆积实例加重循环混乱。

修复后的点位导入模块 #

import tkinter as tk
from tkinter import ttk, messagebox
import csv
from datetime import datetime

class PointNameDialog(tk.Toplevel):
    def __init__(self, parent, old_point_name, point_dict):
        super().__init__(parent)
        self.title('重复点位提示')
        self.point_dict = point_dict
        self.result = None
        
        # 窗口居中
        window_width = 600
        window_height = 300
        screen_width = self.winfo_screenwidth()
        screen_height = self.winfo_screenheight()
        center_x = int(screen_width/2 - window_width / 2)
        center_y = int(screen_height/2 - window_height / 2)
        self.geometry(f'{window_width}x{window_height}+{center_x}+{center_y}')
        
        # 锁定弹窗，必须处理完才能操作主窗口
        self.transient(parent)
        self.grab_set()
        
        label_text = f"点位名称 {old_point_name} 已存在，请输入新的唯一点位名称："
        new_point_label = ttk.Label(self, text=label_text, font=('helvetica', 10))
        new_point_label.grid(row=0, column=0, ipadx=10, ipady=10, padx=20, pady=20)
        
        self.entry_box = ttk.Entry(self, font=('helvetica', 10))
        self.entry_box.grid(row=1, column=0, ipadx=10, ipady=10, padx=20, pady=10)
        self.entry_box.focus_set()  # 自动聚焦输入框
        
        enter_button = ttk.Button(self, text='确认', command=self.validate_input)
        enter_button.grid(row=2, column=0, ipadx=10, ipady=10, padx=20, pady=20)
        
        # 绑定回车按键触发确认
        self.entry_box.bind('<Return>', lambda e: self.validate_input())

    def validate_input(self):
        new_name = self.entry_box.get().strip()
        if not new_name:
            messagebox.showwarning('输入无效', '点位名称不能为空！')
            return
        if new_name in self.point_dict:
            messagebox.showwarning('重复点位', f'点位名称 {new_name} 已存在，请重新输入！')
            self.entry_box.delete(0, tk.END)
            return
        self.result = new_name
        self.destroy()

def get_new_point_name(parent, old_point_name, point_dict):
    dialog = PointNameDialog(parent, old_point_name, point_dict)
    parent.wait_window(dialog)  # 等待弹窗关闭
    return dialog.result

def import_points(file_location, point_dict, parent):
    now = datetime.now()
    with open(file_location, newline='') as csv_file:
        csv_reader = csv.reader(csv_file, delimiter=',')
        for item in csv_reader:
            point_name = item[0].strip()
            if point_name in point_dict:
                new_name = get_new_point_name(parent, point_name, point_dict)
                if not new_name:  # 处理用户关闭弹窗的情况
                    continue
                item[0] = new_name
            
            point_info_dict = {
                'northing': float(item[1]),
                'easting': float(item[2]),
                'elevation': float(item[3]),
                'description': item[4],
                'time': now.strftime('%H:%M:%S'),
                'date': now.strftime('%m/%d/%Y')
            }
            point_dict[item[0]] = point_info_dict
    return point_dict

主GUI对应修改 #

def import_points(self):
    global point_dict
    # 修正文件选择对话框类型
    import_file = fd.askopenfilename(
        initialdir=r'C:\Users\Tim\Desktop\Code\Python\Surveying_Program',
        title='选择导入文件',
        filetype=(('文本文件', '*.txt'), ('所有文件', '*.*'))
    )
    if not import_file:  # 用户取消选择文件时返回
        return
    # 传递主窗口实例给导入模块
    point_dict = point_importer.import_points(import_file, point_dict, self)
    print(point_dict)
    self.save_file()

额外优化建议 #

1. 替换全局变量：将filename、point_dict改为App类的实例属性，避免全局变量状态混乱。
2. 增强输入验证：导入CSV时验证每行数据格式（如坐标是否为数字），防止程序崩溃。
3. 统一组件样式：用ttk组件替代原生tk组件，提升界面一致性。
4. 优化文件操作：new_file方法中避免创建空文件后立即保存空字典，仅在有数据时保存。

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