Tkinter中Label使用config修改文本时新旧文本重叠显示问题

问题复现 #

修改Label的text属性后，旧文本未消失和新文本重叠，对应代码和运行效果如下：

根本原因 #

90%以上的该类问题都是每次更新文本时重复创建了新的Label实例，且新Label和旧Label放在了同一个布局位置，并不是config()方法本身的问题。很多开发者会误将Label的实例化代码写在更新逻辑内部，导致每次触发更新都会生成新的Label堆叠在原有组件上方。

排查&解决方案 #

• 检查Label实例化的位置，全局/当前窗口生命周期内仅初始化一次Label，后续更新仅调用已有实例的config()方法。

错误写法示例（每次更新都新建Label）：

import tkinter as tk
root = tk.Tk()

def update_content():
    # 错误逻辑：函数内每次调用都新建Label
    lab = tk.Label(root, text="新内容")
    lab.pack()

# 首次创建Label
lab = tk.Label(root, text="初始内容")
lab.pack()

tk.Button(root, text="更新文本", command=update_content).pack()
root.mainloop()

正确写法示例（仅修改已有Label的属性）：

import tkinter as tk
root = tk.Tk()

# 仅在初始化阶段创建一次Label
lab = tk.Label(root, text="初始内容")
lab.pack()

def update_content():
    # 直接修改已有实例的text属性
    lab.config(text="新内容")

tk.Button(root, text="更新文本", command=update_content).pack()
root.mainloop()

• 若确认仅创建了一次Label仍出现重叠，可检查两个配置项：

  1. 是否设置了compound属性同时展示图片和文本，更新时未同步清空不需要的旧资源
  2. 是否自定义继承了Label类，重写绘制方法时未先清空旧画布内容

• 快速验证方法：每次更新文本前打印Label的内存id print(id(label))，若每次输出的id不一致，即可确认是重复创建Label的问题。

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