如何自定义ttk.Checkbutton勾选框的背景与激活颜色？

要实现勾选框（含激活/悬停状态）背景和界面背景统一，需要在样式配置中同时指定组件整体背景、勾选指示器的专属背景属性，动态状态颜色需要搭配style.map()做状态映射，具体配置如下：

• 核心配置参数说明：
  • background：Checkbutton组件整体的背景色，即文字所在区域的背景
  • indicatorbackground：勾选方框本身的背景色，是需要修改的核心属性
  • 激活（鼠标悬停）状态属于动态交互状态，无法仅通过style.configure()静态配置完成，需要搭配style.map()绑定对应状态的颜色值，保证交互时背景也和界面统一
• 完整可运行示例代码：

import tkinter as tk
from tkinter import ttk

root = tk.Tk()
# 替换为你自己的界面实际背景色即可
window_bg = "#f0f0f0"
root.configure(bg=window_bg)

style = ttk.Style(root)
# 若使用系统默认原生主题样式不生效，可取消下一行注释切换到支持自定义的clam主题
# style.theme_use("clam")

# 静态基础样式配置
style.configure(
    "TCheckbutton",
    background=window_bg,
    indicatorbackground=window_bg,
    foreground="#000000", # 文字颜色，可按需修改
    indicatorforeground="#0078d7" # 勾选标记的颜色，可按需修改
)

# 动态状态样式配置（覆盖激活/选中/禁用等状态）
style.map(
    "TCheckbutton",
    background=[("active", window_bg), ("disabled", window_bg)],
    indicatorbackground=[("active", window_bg), ("disabled", window_bg)]
)

# 测试组件
test_cb = ttk.Checkbutton(root, text="测试选项")
test_cb.pack(padx=30, pady=30)

root.mainloop()

参考效果：

踩坑提示：Windows、macOS下的默认原生ttk主题会调用系统组件渲染规则，部分样式属性无法被自定义覆盖，遇到配置不生效时切换到clam、alt这类跨平台可自定义主题即可正常修改所有颜色属性。

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