Tkinter跨文件跳转页面报NameError: openTokenWindow未定义

• 直接触发点：Home.py中登录按钮绑定的回调调用了openTokenWindow()函数，但该函数定义在TokenRoom.py中，Home.py既没有在当前作用域定义这个函数，也没有做对应导入，Python解释器找不到对应名称，直接抛出NameError。
• 隐藏阻塞问题：现有代码存在双向顶层导入结构：TokenRoom.py顶层写了from GUI.Home import setHome，如果直接在Home.py顶层导入openTokenWindow，会触发循环导入错误，两个模块互相等待对方加载完成，程序会在启动阶段直接崩溃。
• 附带的潜在bug：现有代码两个窗口都独立创建tk.Tk()实例、各自启动mainloop()，不符合Tkinter的设计逻辑，后续大概率会出现按钮图片被回收消失、窗口事件不响应、焦点异常等问题。

1. 调整TokenRoom.py的导入位置，解决循环导入 #

将TokenRoom.py中对setHome的导入从顶层挪到backHome函数内部，模块顶层加载时不会触发双向引用，从根源避免循环导入，同时补充图片引用防止资源被回收：

import tkinter as tk
from tkinter import *
from PIL import Image,ImageTk

# 移除顶层的 from GUI.Home import setHome

def openTokenWindow(window):

    def backHome():
        # 导入挪到函数内部，调用时才加载，避免循环导入
        from GUI.Home import setHome
        tokenWindow.destroy()
        setHome()
    window.destroy()

    tokenWindow = tk.Tk()
    tokenWindow.title("ELSA")
    tokenWindow.resizable(0, 0)
    tokenWindow.geometry("1100x600")

    # Back Button
    imgBacktButton = Image.open('Images/back.png')
    imgBacktButton = imgBacktButton.resize((60, 60))
    photoBack = ImageTk.PhotoImage(imgBacktButton)

    backButton = tk.Button(tokenWindow)
    backButton.config(command= lambda : backHome())
    backButton.config(font=('Ink Free', 20, 'bold'))
    backButton.config(bg="#fffb1f")
    backButton.config(fg='#fffb1f')
    backButton.config(activebackground='white')
    backButton.config(activeforeground='#fffb1f')
    backButton.config(borderwidth=8)
    backButton.config(image=photoBack)
    backButton.config(compound='left')
    backButton.place(x=80, y=480)
    # 持有图片引用，避免被GC回收导致按钮图标消失
    backButton.image = photoBack

    tokenWindow.mainloop()

2. 在Home.py中导入目标函数 #

在Home.py的顶部导入区域，添加对openTokenWindow的导入，注意导入语句要放在登录按钮配置代码之前：

# 加在Home.py的导入块中
from GUI.TokenRoom import openTokenWindow

同时建议给登录按钮也加上图片引用，在登录按钮配置代码末尾加一行：

loginButton.image = photoLogin

3. （可选优化）规范Tkinter多窗口写法 #

如果不需要每次跳转都彻底销毁重建窗口，更稳定的写法是整个程序只创建一个tk.Tk()根窗口，子页面用tk.Toplevel()创建，只启动一次根窗口的mainloop()，可以避免绝大多数多窗口事件冲突问题。

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