如何通过for循环创建Tkinter多行RadioButton（角色选择菜单）

问题说明 #

需要为角色选择菜单生成多行带图片的RadioButton，通过循环遍历角色列表创建，但目前遇到以下问题：

• 使用pack(side=LEFT)会将所有单选按钮排成单行，超出窗口范围
• 手动拆分到多个Frame，选项仍会超出窗口，且无法实现滚动
• 尝试grid布局时，所有按钮重叠，仅显示最后一项，调整row/column参数也无法正常多行排列

当前代码（简化版） #

import tkinter as tk

window = tk.Tk()
window.geometry("800x640")
window.resizable(False, False)

topframe = tk.Frame(window)
topframe.pack(side=tk.TOP)
frame2 = tk.Frame(window)
frame2.pack(side=tk.TOP)
bottomframe = tk.Frame(window)
bottomframe.pack(side=tk.TOP)

button = tk.Button(topframe, text="开始", command=lambda: None)
button.pack(anchor=tk.N, side=tk.TOP)

# 假设的角色数据
characters = ["角色1", "角色2", "角色3", "角色4", "角色5", "角色6", "角色7", "角色8"]
characterList = [tk.PhotoImage() for _ in characters] # 替换为实际图片
v = tk.IntVar()

# 原pack方式：单行排列超窗口
for index in range(len(characters)):
    rb1 = tk.Radiobutton(frame2,
        compound=tk.TOP,
        image=characterList[index],
        text=characters[index],
        variable=v,
        value=index,
    ).pack(side=tk.LEFT, pady=20, padx=13)

# 原grid尝试：仅显示最后一项
# for index in range(len(characters)):
#     rb1 = tk.Radiobutton(frame2, ...).grid()

解决方案 #

方案1：自动多行Grid布局（基础版） #

核心思路是循环时动态计算每个按钮的行、列索引，设定每行显示的数量（比如5个），自动换行排列。

import tkinter as tk

window = tk.Tk()
window.geometry("800x640")
window.resizable(False, False)

# 替换为你的实际角色数据
characters = ["角色1", "角色2", "角色3", "角色4", "角色5", "角色6", "角色7", "角色8", "角色9", "角色10"]
characterList = [tk.PhotoImage(file=f"char_{i}.png") for i in range(len(characters))] # 替换图片路径
v = tk.IntVar()

topframe = tk.Frame(window)
topframe.pack(side=tk.TOP)
button = tk.Button(topframe, text="开始", command=lambda: print(f"选中角色：{characters[v.get()]}"))
button.pack(anchor=tk.N, side=tk.TOP)

# 存放单选按钮的主Frame
char_container = tk.Frame(window)
char_container.pack(side=tk.TOP, fill=tk.BOTH, expand=True, padx=10, pady=10)

# 设定每行显示的按钮数量
per_row = 5

for idx in range(len(characters)):
    # 计算当前按钮的行、列
    row_num = idx // per_row
    col_num = idx % per_row
    
    rb = tk.Radiobutton(
        char_container,
        compound=tk.TOP,
        image=characterList[idx],
        text=characters[idx],
        variable=v,
        value=idx
    )
    rb.grid(row=row_num, column=col_num, padx=13, pady=10)

window.mainloop()

方案2：可滚动的多行布局（角色数量较多时） #

如果角色数量多，多行后超出窗口高度，可结合Canvas和Scrollbar实现滚动功能，同时保持多行排列。

import tkinter as tk

window = tk.Tk()
window.geometry("800x640")
window.resizable(False, False)

characters = ["角色1", "角色2", "角色3", "角色4", "角色5", "角色6", "角色7", "角色8", "角色9", "角色10",
              "角色11", "角色12", "角色13", "角色14", "角色15"]
characterList = [tk.PhotoImage(file=f"char_{i}.png") for i in range(len(characters))]
v = tk.IntVar()

topframe = tk.Frame(window)
topframe.pack(side=tk.TOP)
button = tk.Button(topframe, text="开始", command=lambda: print(f"选中角色：{characters[v.get()]}"))
button.pack(anchor=tk.N, side=tk.TOP)

# 滚动区域容器
scroll_container = tk.Frame(window)
scroll_container.pack(side=tk.TOP, fill=tk.BOTH, expand=True, padx=10, pady=10)

# 创建Canvas和滚动条
canvas = tk.Canvas(scroll_container)
canvas.pack(side=tk.LEFT, fill=tk.BOTH, expand=True)

scrollbar = tk.Scrollbar(scroll_container, orient=tk.VERTICAL, command=canvas.yview)
scrollbar.pack(side=tk.RIGHT, fill=tk.Y)

canvas.configure(yscrollcommand=scrollbar.set)
canvas.bind('<Configure>', lambda e: canvas.configure(scrollregion=canvas.bbox("all")))

# 存放单选按钮的Frame（嵌入Canvas）
char_frame = tk.Frame(canvas)
canvas.create_window((0, 0), window=char_frame, anchor="nw")

# 每行显示5个按钮
per_row = 5

for idx in range(len(characters)):
    row_num = idx // per_row
    col_num = idx % per_row
    
    rb = tk.Radiobutton(
        char_frame,
        compound=tk.TOP,
        image=characterList[idx],
        text=characters[idx],
        variable=v,
        value=idx
    )
    rb.grid(row=row_num, column=col_num, padx=13, pady=10)

window.mainloop()

错误原因说明 #

1. grid布局失败：之前的代码没有为每个按钮设置独立的row和col，所有按钮都默认放在row=0, column=0的位置，后面的按钮会覆盖前面的，因此仅显示最后一项。
2. 手动拆分Frame：这种方式需要硬编码拆分索引，无法适配角色数量变化，且无法自动换行，超出窗口后也难以实现滚动。

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