CustomTkinter 快速上手一条命令安装30 秒跑通第一个窗口【免费下载链接】CustomTkinterA modern and customizable python UI-library based on Tkinter项目地址: https://gitcode.com/gh_mirrors/cu/CustomTkinterCustomTkinter 是建立在 Tkinter 之上的 Python GUI 库能让普通 Tk 界面拥有现代观感。它的安装只有一条 pip 命令这篇文章按值不值得装 → 怎么装 → 怎么跑 → 怎么用 → 容易踩的坑带你走一遍看完就能跑通第一个窗口。先判断它适不适合你CustomTkinter 给 Tkinter 换了一套现代外观的控件创建方式和你写原生 tkinter 代码一致也能和普通 Tk 元素混着放。窗口和控件颜色跟随系统深浅色模式高分屏 DPI 缩放在 Windows 与 macOS 上自动生效三端观感统一。常用的 CTk 控件一次列全CTkButton、CTkLabel、CTkEntry、CTkCheckBox、CTkSwitch、CTkSlider、CTkProgressBar、CTkComboBox、CTkTabview、CTkTextbox、CTkScrollableFrame外加 CTkToplevel 弹出窗口。适合已经在用 Tkinter但受够了老派外观需要跨平台一致的工具类小应用想给现有 Tkinter 项目换皮代码改动量很小想要现成的深色/浅色主题不想自己画控件不适合需要庞大第三方控件生态的场景Qt 系更划算。环境与版本要求项目要求Python≥ 3.7推荐 3.9库当前版本6.0.0第三方依赖darkdetect、packagingpip 自动处理平台Windows / macOS / Linux一条命令安装 CustomTkinter跑命令前先确认解释器版本python --version低于 3.7 的先去官网升级。然后装库并立刻验证pip install customtkinter python -c import customtkinter; print(customtkinter.__version__)第二行应打印 6.0.0。如果数字对不上多半是pip和python指向了不同解释器检查一下环境。系统只有pip3时把上面命令换成pip3 install customtkinter即可。这个库迭代很快隔段时间跑一次pip install customtkinter --upgrade保持最新。30 秒创建第一个窗口新建一个 py 文件写入下面的最小示例。思路用CTk建主窗口用CTkButton替换 tkinter 的 Buttonpack、grid、place布局照旧可用。import customtkinter customtkinter.set_appearance_mode(System) # 跟随系统深浅色 customtkinter.set_default_color_theme(blue) # 默认蓝色主题 app customtkinter.CTk() app.title(My First App) app.geometry(400x240) def on_click(): print(button clicked) button customtkinter.CTkButton(masterapp, textCTkButton, commandon_click) button.place(relx0.5, rely0.5, anchorcustomtkinter.CENTER) app.mainloop()注意开头两行全局设置外观模式和主题对当前进程全局生效写一次即可按钮的command参数就是点击回调语义和 tkinter 的 Button 相同。如果窗口一闪而过多半是漏了末尾的app.mainloop()——它负责启动事件循环。跑起来是一个居中按钮的窗口macOS 上效果如下想看全部控件长什么样仓库自带的 complex_example 是最佳起点Windows 11 深色模式下的完整界面上手后最常用的三个能力1. 切换主题和外观模式外观模式三选一System默认跟随系统、Light、Dark。内置 4 个颜色主题主题观感blue默认蓝灰色系最百搭dark-blue更沉的蓝适合纯深色应用green绿色强调色区分度高gold6.0.0 新增金色强调色换主题一行搞定customtkinter.set_default_color_theme(green)。外观模式也能运行时切换把set_appearance_mode接到 CTkOptionMenu 的command上就能做出设置里点一下、全界面变深色的效果。主题本质是 JSON 文件内置的放在customtkinter/assets/themes/目录set_default_color_theme传自定义 json 的路径就能加载自己的配色。2. 可滚动框架和带图按钮CTkScrollableFrame支持垂直/水平两个方向滚动里面能放任意控件做设置页、列表页很常用frame customtkinter.CTkScrollableFrame(masterapp, width350, height250) frame.pack(pady20) for i in range(20): customtkinter.CTkLabel(frame, textf项目 {i 1}).pack(pady5)按钮挂图片也简单把 PIL 加载的图像传给CTkButton的image参数再用compound控制图文相对位置完整写法参考 examples/image_example.py。3. Showroom零代码控件展厅6.0.0 起装好库就有展厅可用import customtkinter as ctk后调用ctk.run_showroom()打开一个包含全部控件的窗口。侧边栏能实时切主题、外观模式和 UI 缩放80%~120%调参数、看效果都很省事。常见坑与版本建议 ⚠️macOS 深色标题栏不生效需要 Python 3.10 或 Anaconda 版 PythonTcl/Tk ≥ 8.6.9否则窗口头部仍是浅色。Linux 上界面偏小高分屏 DPI 缩放只覆盖 Windows 和 macOSLinux 按 100% 绘制属正常现象。界面发虚、缩放异常优先--upgrade到最新版6.0.0 修复了 configure/cget 与多项交互行为。想跟最新开发进度git clone https://gitcode.com/gh_mirrors/cu/CustomTkinter后在仓库目录执行pip install -e .做源码安装。控件行为拿不准test/unit_tests/ 的单元测试与 examples/ 的示例是最好的活文档。下一步可以做什么把窗口改成CTkEntryCTkButton组合做一个输入回显小表单用CTkTabview把功能拆到选项卡里模仿 complex_example 的布局写一份自己的主题 json用set_default_color_theme(路径)加载打开 examples/complex_example.py对照源码理解侧边栏与网格布局加一个CTkToplevel弹出层体验多窗口程序【免费下载链接】CustomTkinterA modern and customizable python UI-library based on Tkinter项目地址: https://gitcode.com/gh_mirrors/cu/CustomTkinter创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
