Tkinter复选框无法保持勾选状态的问题求助

为学校项目开发程序时，使用Tkinter创建的复选框初始状态正常，但点击后无法保持勾选——点击时勾选标记短暂显示，按住鼠标时保持，松开后消失。代码是从另一个可正常运行的程序中复制的，无法定位问题。相关代码如下：

checkbutton_frame=tkinter.Frame(frame1, bg="#0073CF")
checkbutton_frame.grid(row=5,column=0)

liver_var=tkinter.StringVar(value=0)
liver_check=tkinter.Checkbutton(checkbutton_frame, text="Liver", font=("Calibri",20), 
fg="#FFFFFF", variable=liver_var, onvalue=1, offvalue=0, bg="#0073CF")
liver_check.grid(row=0, column=0)

heart_var=tkinter.StringVar(value=0)
heart_check=tkinter.Checkbutton(checkbutton_frame, text="Heart", font=("Calibri",20), 
fg="#FFFFFF", variable=heart_var, onvalue=1, offvalue=0, bg="#0073CF")
heart_check.grid(row=0, column=1)

lungR_var=tkinter.StringVar(value=0)
lungR_check=tkinter.Checkbutton(checkbutton_frame, text="Lung(R)", font=("Calibri",20), 
fg="#FFFFFF", variable=lungR_var, onvalue=1, offvalue=0, bg="#0073CF")
lungR_check.grid(row=0, column=2)

lungL_var=tkinter.StringVar(value=0)
lungL_check=tkinter.Checkbutton(checkbutton_frame, text="Lung(L)", font=("Calibri",20), 
fg="#FFFFFF", variable=lungL_var, onvalue=1, offvalue=0, bg="#0073CF")
lungL_check.grid(row=0, column=3)

kidneyR_var=tkinter.StringVar(value=0)
kidneyR_check=tkinter.Checkbutton(checkbutton_frame, text="Kidney(R)", font=("Calibri",20), fg="#FFFFFF", variable=kidneyR_var, onvalue=1, offvalue=0, bg="#0073CF")
kidneyR_check.grid(row=0, column=4)

kidneyL_var=tkinter.StringVar(value=0)
kidneyL_check=tkinter.Checkbutton(checkbutton_frame, text="Kidney(L)", font=("Calibri",20), fg="#FFFFFF", variable=kidneyL_var, onvalue=1, offvalue=0, bg="#0073CF")
kidneyL_check.grid(row=0, column=5)

pancreas_var=tkinter.StringVar(value=0)
pancreas_check=tkinter.Checkbutton(checkbutton_frame, text="Pancreas", font=("Calibri",20), fg="#FFFFFF", variable=pancreas_var, onvalue=1, offvalue=0, bg="#0073CF")
pancreas_check.grid(row=1, column=2)

sbowel_var=tkinter.StringVar(value=0)
sbowel_check=tkinter.Checkbutton(checkbutton_frame, text="Small Bowel", font=("Calibri",20), fg="#FFFFFF", variable=sbowel_var, onvalue=1, offvalue=0, bg="#0073CF")
sbowel_check.grid(row=1, column=3)

cornea_var=tkinter.StringVar(value=0)
cornea_check=tkinter.Checkbutton(checkbutton_frame, text="Cornea", font=("Calibri",20), fg="#FFFFFF", variable=cornea_var, onvalue=1, offvalue=0, bg="#0073CF")
cornea_check.grid(row=1, column=4)

for widget in checkbutton_frame.winfo_children():
    widget.grid_configure(pady=5, padx=10)

问题原因分析 #

• 变量生命周期不足：你定义的StringVar属于局部变量，如果这段代码位于函数内部，函数执行结束后局部变量会被Python垃圾回收机制清理，导致复选框失去绑定的状态变量，无法维持勾选状态。这是Tkinter中非常常见的问题——控件绑定的变量必须有足够长的存活周期，不能被提前回收。
• 类型隐性不匹配（次要）：使用StringVar但设置onvalue/offvalue为整数1/0，虽然Tkinter会自动转换类型，但可能存在隐性的不一致风险，不过这不是导致勾选状态无法保持的核心原因。

解决建议 #

方案1：提升变量作用域 #

如果代码在函数内，将所有StringVar声明为全局变量；如果是面向对象写法，将变量作为类的实例属性，确保变量不会被提前回收：

# 函数内使用全局变量示例
def setup_checkbuttons():
    global liver_var, heart_var, lungR_var, lungL_var, kidneyR_var, kidneyL_var, pancreas_var, sbowel_var, cornea_var
    
    checkbutton_frame=tkinter.Frame(frame1, bg="#0073CF")
    checkbutton_frame.grid(row=5,column=0)

    liver_var=tkinter.StringVar(value="0")
    liver_check=tkinter.Checkbutton(checkbutton_frame, text="Liver", font=("Calibri",20), 
    fg="#FFFFFF", variable=liver_var, onvalue="1", offvalue="0", bg="#0073CF")
    liver_check.grid(row=0, column=0)
    # 其余变量和控件定义同理

# 类结构使用实例属性示例
class App:
    def __init__(self, root):
        self.frame1 = tkinter.Frame(root)
        self.frame1.pack()
        self._setup_checkbuttons()
    
    def _setup_checkbuttons(self):
        checkbutton_frame=tkinter.Frame(self.frame1, bg="#0073CF")
        checkbutton_frame.grid(row=5,column=0)

        self.liver_var=tkinter.StringVar(value="0")
        liver_check=tkinter.Checkbutton(checkbutton_frame, text="Liver", font=("Calibri",20), 
        fg="#FFFFFF", variable=self.liver_var, onvalue="1", offvalue="0", bg="#0073CF")
        liver_check.grid(row=0, column=0)
        # 其余控件绑定self对应的变量

方案2：统一变量类型（优化） #

既然使用StringVar，建议将onvalue/offvalue改为字符串类型，避免类型转换的潜在问题；或者直接使用IntVar匹配整数状态：

# 使用StringVar并统一字符串值
liver_var=tkinter.StringVar(value="0")
liver_check=tkinter.Checkbutton(..., onvalue="1", offvalue="0", ...)

# 或者改用IntVar
liver_var=tkinter.IntVar(value=0)
liver_check=tkinter.Checkbutton(..., onvalue=1, offvalue=0, ...)

方案3：保留变量引用 #

将所有状态变量存入一个列表或字典，通过额外的引用避免被垃圾回收：

check_vars = []
checkbutton_frame=tkinter.Frame(frame1, bg="#0073CF")
checkbutton_frame.grid(row=5,column=0)

liver_var=tkinter.StringVar(value=0)
check_vars.append(liver_var)
liver_check=tkinter.Checkbutton(checkbutton_frame, text="Liver", font=("Calibri",20), 
fg="#FFFFFF", variable=liver_var, onvalue=1, offvalue=0, bg="#0073CF")
liver_check.grid(row=0, column=0)
# 其余变量同理添加到check_vars列表

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