Tkinter子窗口按钮修改标签文本报错：名称未定义

你遇到的核心问题是变量作用域：lb1是child()函数内部的局部变量，只能在该函数范围内访问，外部的cLabelChange()函数无法读取到它，因此触发“名称未定义”的报错。以下是几种实用的解决方法：

方法1：使用全局变量 #

在函数外部声明全局变量，在child()里标记使用全局变量，让cLabelChange()可以访问：

import tkinter as tk
root = tk.Tk()
root.geometry("300x300")
root.title("Root")

lb1 = None  # 全局声明变量

def child(): #Create child window
    global lb1  # 标记使用全局变量lb1
    child = tk.Toplevel()
    child.geometry("350x350+100+100")
    child.title("Child Window")
    
    lb1 = tk.Label(child, text = "Child Label")
    lb1.pack()
    
    Cbtn = tk.Button(child, text = "Change Child Label text", command = cLabelChange)
    Cbtn.pack()

def cLabelChange():
    lb1.configure(text = "I changed this text")

btn = tk.Button(root, text = "Open Child.", command = child)
btn.pack()

root.mainloop()

方法2：嵌套函数 #

将cLabelChange()嵌套在child()内部，这样它就能直接访问父函数里的lb1变量：

import tkinter as tk
root = tk.Tk()
root.geometry("300x300")
root.title("Root")

def child(): #Create child window
    child = tk.Toplevel()
    child.geometry("350x350+100+100")
    child.title("Child Window")
    
    lb1 = tk.Label(child, text = "Child Label")
    lb1.pack()
    
    # 嵌套函数，直接访问父函数的lb1
    def cLabelChange():
        lb1.configure(text = "I changed this text")
    
    Cbtn = tk.Button(child, text = "Change Child Label text", command = cLabelChange)
    Cbtn.pack()

btn = tk.Button(root, text = "Open Child.", command = child)
btn.pack()

root.mainloop()

方法3：用lambda传递参数 #

通过lambda表达式把lb1直接作为参数传给cLabelChange()，无需修改变量作用域：

import tkinter as tk
root = tk.Tk()
root.geometry("300x300")
root.title("Root")

def cLabelChange(label):
    label.configure(text = "I changed this text")

def child(): #Create child window
    child = tk.Toplevel()
    child.geometry("350x350+100+100")
    child.title("Child Window")
    
    lb1 = tk.Label(child, text = "Child Label")
    lb1.pack()
    
    # lambda将lb1作为参数传递给cLabelChange
    Cbtn = tk.Button(child, text = "Change Child Label text", command = lambda: cLabelChange(lb1))
    Cbtn.pack()

btn = tk.Button(root, text = "Open Child.", command = child)
btn.pack()

root.mainloop()

方法4：面向对象实现（推荐） #

用类封装子窗口的逻辑，结构清晰，适合复杂界面的扩展：

import tkinter as tk

class ChildWindow:
    def __init__(self, parent):
        self.child = tk.Toplevel(parent)
        self.child.geometry("350x350+100+100")
        self.child.title("Child Window")
        
        self.lb1 = tk.Label(self.child, text = "Child Label")
        self.lb1.pack()
        
        self.Cbtn = tk.Button(self.child, text = "Change Child Label text", command = self.cLabelChange)
        self.Cbtn.pack()
    
    def cLabelChange(self):
        self.lb1.configure(text = "I changed this text")

root = tk.Tk()
root.geometry("300x300")
root.title("Root")

def open_child():
    ChildWindow(root)

btn = tk.Button(root, text = "Open Child.", command = open_child)
btn.pack()

root.mainloop()

各方法适用场景 #

• 全局变量：适合极简脚本，不推荐复杂项目（易引发变量冲突）
• 嵌套函数：逻辑紧凑，适合单个子窗口的简单需求
• lambda传参：灵活快速，无需重构代码
• 面向对象：结构清晰、可维护性高，是中大型Tkinter项目的最佳实践

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