Tkinter在MacOS M1 Max设备上无法修改窗口背景色（始终显示黑色）

在MacOS M1 Max设备上使用Tkinter开发GUI程序时，出现窗口背景色设置失效的异常：无论使用哪种常规配置方式，窗口背景始终显示为黑色。
已验证无效的常规配置方式：

• top.config(bg='blue')
• top.config(background='blue')
• top.configure(bg='blue')
• top.configure(background='blue')
• top['bg']='blue'
• top['background']='blue'

异常复现代码（除背景色设置失效外，其余功能均可正常运行）：

def openWorkoutCustomization():
    top = Tk(className='Customize your Workout!')
    top.config(background="blue")
    top.title("Customize Your Workout!")
    top.geometry("900x600")

    variable = StringVar(top)
    variable.set(workout_list[0])

    w = OptionMenu(top, variable, *workout_list)
    w.pack()

    button = Button(top, text="Start", command= lambda: startWorkout(variable.get()))
    button.pack()

    top.mainloop()

该异常是M系列芯片Mac设备上，旧版本Tkinter 8.6与macOS 13+系统原生渲染机制的兼容bug：根Tk窗口的底层层级没有正确响应背景色配置，会被系统深色模式渲染逻辑强制覆盖为黑色，直接对根窗口设置bg/background属性不会触发底层渲染刷新。

方案1：使用全窗口铺满的Frame作为容器（兼容所有Tk版本，无需升级依赖） #

不要把控件直接放在根Tk窗口上，创建一个占满整个窗口区域的Frame作为根容器，将背景色设置在这个Frame上，所有业务控件都放在该Frame内部即可。
修正后的代码示例：

def openWorkoutCustomization():
    top = Tk(className='Customize your Workout!')
    top.title("Customize Your Workout!")
    top.geometry("900x600")

    # 创建铺满全窗口的容器Frame，设置目标背景色
    container = Frame(top, bg="blue")
    # 配置Frame随窗口缩放自动适配，始终铺满整个可视区域
    container.pack(fill=BOTH, expand=True)

    variable = StringVar(top)
    variable.set(workout_list[0])

    # 所有控件的父组件替换为容器Frame，不再直接挂载到根窗口
    w = OptionMenu(container, variable, *workout_list)
    w.pack(pady=20)

    button = Button(container, text="Start", command= lambda: startWorkout(variable.get()))
    button.pack()

    top.mainloop()

方案2：升级Tkinter到修复兼容bug的版本 #

如果是通过Homebrew安装的Python，执行对应Python版本的tkinter安装命令，绑定最新版Tk渲染库即可直接修复根窗口背景色失效问题：

# 将命令中3.12替换为本地实际运行的Python版本号
brew install python-tk@3.12

安装完成后重启开发环境，原有直接设置根窗口bg属性的代码即可正常生效。

方案3：全局设置Tk调色板 #

在创建根窗口后第一时间调用tk_setPalette方法，全局强制覆盖背景色配置，部分场景下可绕过渲染bug：

top = Tk(className='Customize your Workout!')
# 强制设置全局调色板背景色
top.tk_setPalette(background="blue")

注意：尽量避免在一个Tkinter程序中创建多个Tk()实例，多窗口场景推荐使用Toplevel组件，否则可能触发其他不可预期的渲染异常。

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