tkinter中Checkbutton复选框滚动条不生效，如何让列表框与复选框共用滚动条

问题根源 #

• 同时使用place()和window_create()往ScrolledText中插入控件，place()是绝对定位逻辑，不受ScrolledText滚动控制，直接导致滚动失效。删除place()后仅显示最后一个复选框，是因为循环内多次覆盖cb变量，最终仅最后一个复选框被window_create()插入到文本组件中，前面创建的复选框都未被添加。
• 多个复选框绑定同一个IntVar变量，会导致选中任意一个复选框时其余绑定同一变量的复选框同步触发状态变更。
• tkinter的控件变量（如IntVar）如果仅作为局部变量存在，会被Python垃圾回收机制自动清理，导致复选框状态失效。

实现方案 #

方案1：保留原Listbox+Text结构，共用滚动条同步滚动 #

该方案无需改动原有功能逻辑，仅需调整滚动条绑定逻辑即可实现同步滚动，推荐优先使用。

# 完整修正代码
import tkinter as tk
from tkinter import scrolledtext
import csv

def startButton(self):
    frame = tk.Frame(self.root, width=1110, height=552)
    frame.place(x=10, y=69)
    frame.configure(background="light gray")

    # 定义共用垂直滚动条
    scroll_y = tk.Scrollbar(frame, orient='vertical')
    scroll_y.place(x=457, y=5, height=542)

    # Listbox绑定滚动条
    listbox = tk.Listbox(frame, width=50, height=26, font=('Times New Roman', 13),
                         yscrollcommand=scroll_y.set)
    listbox.place(x=5, y=5)

    # 用普通Text替代ScrolledText，绑定同一滚动条
    widget = tk.Text(frame, width=28, height=33, yscrollcommand=scroll_y.set, background="light gray")
    widget.place(x=480, y=5)

    # 滚动条同时控制两个组件滚动
    def sync_scroll(*args):
        listbox.yview(*args)
        widget.yview(*args)
    scroll_y.config(command=sync_scroll)

    # 原有水平滚动条保留，仅控制Listbox横向滚动
    scroll_x = tk.Scrollbar(frame, orient='horizontal')
    scroll_x.place(x=5, y=530, width=454)
    scroll_x.config(command=listbox.xview)
    listbox.config(xscrollcommand=scroll_x.set)

    data = {}
    self.check_vars = [] # 实例属性存储复选框变量，避免被回收

    with open(self.filename) as f:
        reader = csv.DictReader(f, delimiter=',')
        for row in reader:
            if row['column1']:
                key = row['column1']
                data[key] = []
            data[key].append(row['Result'])
        
        myCheckBoxfont = ('Arial Bold', 8)
        for i, item in enumerate(data[key]):
            listbox.insert('end', item)
            if item != "":
                chk_state = tk.IntVar()
                self.check_vars.append(chk_state)
                cb = tk.Checkbutton(widget, text='PASS', variable=chk_state,
                                    onvalue=1, font=myCheckBoxfont,
                                    command=lambda i=i: self.onCheckButton(i))
                widget.window_create('end', window=cb)
            widget.insert('end', '\n')
    widget['state'] = 'disabled'

方案2：单ScrolledText同时承载列表文本和复选框的修正代码 #

如果要保留合并到同一个滚动文本框的逻辑，修正后代码如下：

def startButton(self):
    frame = tk.Frame(self.root, width=1110, height=552)
    frame.place(x=10, y=69)
    frame.configure(background="light gray")

    widget = scrolledtext.ScrolledText(frame, width=80, height=26, background="yellow")
    widget.place(x=5, y=5)

    data = {}
    self.check_vars = []

    with open(self.filename) as f:
        reader = csv.DictReader(f, delimiter=',')
        for row in reader:
            if row['column1']:
                key = row['column1']
                data[key] = []
            data[key].append(row['Result'])
        
        myCheckBoxfont = ('Arial Bold', 8)
        for i, item in enumerate(data[key]):
            # 插入列表文本，留足位置放复选框
            widget.insert('end', f"{item:<45}")
            if item != "":
                # 每个复选框使用独立变量
                var1 = tk.IntVar()
                var2 = tk.IntVar()
                var3 = tk.IntVar()
                self.check_vars.extend([var1, var2, var3])
                # 依次插入三个复选框，不要用place
                cb1 = tk.Checkbutton(widget, text='Text1', variable=var1, onvalue=1,
                                    font=myCheckBoxfont, command=lambda i=i: self.onCheckButton(i))
                widget.window_create('end', window=cb1)
                widget.insert('end', '  ')

                cb2 = tk.Checkbutton(widget, text='Text2', variable=var2, onvalue=1,
                                    font=myCheckBoxfont, command=lambda i=i: self.onCheckButton(i))
                widget.window_create('end', window=cb2)
                widget.insert('end', '  ')

                cb3 = tk.Checkbutton(widget, text='Text23', variable=var3, onvalue=1,
                                    font=myCheckBoxfont, command=lambda i=i: self.onCheckButton(i))
                widget.window_create('end', window=cb3)
            widget.insert('end', '\n')
    widget['state'] = 'disabled'

关键注意事项 #

• 往Text/ScrolledText中插入自定义控件仅使用window_create()方法即可，不要同时使用place()/pack()/grid()，否则会脱离文本滚动逻辑。
• 每个复选框需要绑定独立的IntVar变量，所有变量要存储为类实例属性，避免局部变量被垃圾回收导致状态失效。
• 多组件同步滚动的核心逻辑是：所有需要同步滚动的组件都将自身的yscrollcommand绑定到同一个滚动条的set方法，同时滚动条的command绑定自定义方法，同步调用所有组件的yview方法。

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