customtkinter默认并非暗黑风格，必须显式调用set_appearance_mode("dark")与set_default_color_theme()成对配置；否则界面可能错乱、发灰或回退至原生tk样式。
CustomTkinter 暗黑主题是否需要手动配色
不需要。CustomTkinter 默认就是暗黑风格，ctk.set_appearance_mode("dark") 是冗余调用——它已是默认行为。真正要改的是主题色（accent color），比如把蓝色高亮换成紫色，得用 ctk.set_default_color_theme("blue")，可选值包括 "blue"、"green"、"dark-blue"。注意 "dark-blue" 并非“更暗”，而是深蓝主色调+圆角+阴影的视觉组合；实际界面明暗由系统级 set_appearance_mode 控制，和 color_theme 无关。
为什么窗口启动后仍是亮色或颜色错乱
常见于两类错误：
- 在创建
ctk.CTk()实例之前调用ctk.set_appearance_mode("dark")—— 这没问题；但若在ctk.CTk()之后、.mainloop()之前又调了set_appearance_mode("light")，就会覆盖 - 混用 tkinter 原生组件（如
tk.Button）和 CustomTkinter 组件（如ctk.CTkButton）。原生组件不响应set_appearance_mode，会突兀地保持系统亮色，破坏统一性 - Linux 上未启用 X11 的
GTK_THEME或 Wayland 下未设置environment variable，可能导致字体渲染发灰或控件边框消失（此时加一句os.environ["XDG_CURRENT_DESKTOP"] = "Unity"有时能缓解）
如何让自定义组件（如 Canvas、Matplotlib 图表）融入暗黑UI
CustomTkinter 不接管第三方绘图区域，需手动适配：
-
Canvas背景填色必须显式设为fg_color="transparent"或匹配当前 theme 的背景色，推荐用ctk.ThemeManager.theme["CTkFrame"]["fg_color"][1]动态取暗色值（索引[1]对应 dark 模式） - Matplotlib 嵌入时，
plt.style.use("dark_background")仅影响图表，坐标轴文字仍可能发白——需额外设置plt.rcParams["text.color"] = "w"和plt.rcParams["axes.labelcolor"] = "w" - 若用
ctk.CTkScrollableFrame包裹长列表，其内部子组件的fg_color默认继承父容器，但滚动条 thumb 颜色需单独用scrollbar_button_color参数控制
打包成 exe 后暗黑主题失效怎么办
PyInstaller 打包时，CustomTkinter 的内置主题 JSON 文件（如 themes/dark-blue.json）未被自动收集。运行时找不到主题，回退到 tkinter 原生样式。
解决方法：在打包命令中显式添加数据文件
pyinstaller --add-data "venv/Lib/site-packages/customtkinter/themes;customtkinter/themes" app.py
路径需根据实际环境调整：venv 替换为你的 Python 环境路径（如 ./.venv 或 /opt/anaconda3/lib/python3.9/site-packages），Windows 下分隔符用分号，macOS/Linux 用冒号。漏掉这一步，哪怕代码里写了 set_default_color_theme("dark-blue") 也无效。
主题文件缺失是静默失败，不会报错，只表现为按钮变扁平、圆角消失、阴影丢失——这些细节恰恰是暗黑 UI 的质感来源，容易被当成“只是不好看”，其实根本没加载主题。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
