Python Tkinter全局变量跨函数不识别问题求助

报错原因与修复 #

你遇到的UnboundLocalError是因为在characterImage函数里对imageAppear进行赋值操作时，Python默认将其视为局部变量，而非你在main中定义的全局变量。要解决这个问题，需要在函数开头明确声明使用全局变量。

另外，图片叠加的问题是因为每次切换角色都新建了一个Label，而非复用已有的label1。

修改步骤 #

1. 在characterImage函数开头添加全局变量声明，明确使用全局的imageAppear、label1和selectedCharacter：

   def characterImage(*args):
       global imageAppear, label1, selectedCharacter
   

2. 复用已有的label1，替换新建Label的代码，改为更新已有Label的图片：
   把

   label1 = tk.Label(image=test)
   label1.image = test
   label1.pack()
   

   修改为：

   label1.config(image=test)
   label1.image = test  # 保留引用防止图片被垃圾回收
   

3. 在clearImage函数中也添加全局变量声明，避免同样的局部变量错误：

   def clearImage():
       global label1
       label1.config(image="")
   

修改后的完整代码 #

### MAIN WINDOW ###

# Using tkinter version 8.6
# Using pack as the LayoutManager, 

import tkinter as tk
from tkinter import *
from tkinter import filedialog
from PIL import Image, ImageTk
import pathlib
from pathlib import Path

def main():
    root = tk.Tk()
    root.geometry('1280x760')
    root.title("Slippi Stats")
    title = Label(root, text = "Slippi Stats", font = ('Helvetica 20 bold')).pack(pady = 20)
    
    # Create a File Explorer label
    global label_file_explorer
    label_file_explorer = Label(root, 
                                text = "File Explorer using Tkinter",
                                width = 100, height = 4)
    
    # Select Character
    characters = ["Mario", "Bowser", "Peach", "Yoshi", "Donkey Kong",
                  "Captain Falcon", "Fox", "Ness", "Ice Climbers",
                  "Kirby", "Samus", "Zelda", "Link", "Pikachu",
                  "Jigglypuff", "Dr. Mario", "Luigi", "Ganondorf",
                  "Falco", "Young Link", "Pichu", "Mewtwo",
                  "Mr. Game & Watch", "Marth", "Roy"]
    global selectedCharacter
    global label1
    label1 = Label(root, image = "")
    label1.pack()  # 提前完成布局，后续仅更新图片
    global imageAppear
    imageAppear = True
    selectedCharacter = tk.StringVar(master=root)
    selectedCharacter.set("Mario")
    selectedCharacter.trace_add('write', characterImage)
    characterLabel = tk.Label(root, text="Select a character to train against")
    characterLabel.pack(pady=10)
    dropdown = tk.OptionMenu(root, selectedCharacter, *characters)
    dropdown.pack()
    
    button_explore = Button(root, 
                            text = "Browse Files",
                            command = browseFiles)
    label_file_explorer.pack(pady=10)
    button_explore.pack(pady=10)
    quitButton = tk.Button(text="Quit", command=root.destroy)
    quitButton.pack(pady = 100)
    # 初始化显示默认角色图片
    characterImage()
    root.mainloop()

def characterImage(*args):
    global imageAppear, label1, selectedCharacter
    if imageAppear == True:
        clearImage()
    path = pathlib.Path(__file__).parent.resolve()
    path = str(path) + "\\CharacterImages\\{}.jpg".format(selectedCharacter.get())
    path = Path(path)
    character_img = Image.open(path)
    test = ImageTk.PhotoImage(character_img)
    label1.config(image=test)
    label1.image = test
    imageAppear = True

def clearImage():
    global label1
    label1.config(image = "")

def browseFiles():
    filename = filedialog.askopenfilename(initialdir = "/",
                                          title = "Select a File",
                                          filetypes = (("Slippi Files",
                                                        "*.slp*"),
                                                       ("All files",
                                                        "*.*")))
    label_file_explorer.configure(text="File Opened: "+filename)
main()

额外优化说明 #

• 在main中提前对label1执行pack()，后续只需要更新图片内容，无需重复执行布局操作
• 修复了路径拼接的写法，用str(path)替代path._str（_str是内部属性，不建议直接调用）
• 初始化时主动调用characterImage()，确保默认角色图片正常显示

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