CustomTkinter 字体与图像指南CTkFont 与 CTkImage 实现跨平台统一视觉【免费下载链接】CustomTkinterA modern and customizable python UI-library based on Tkinter项目地址: https://gitcode.com/gh_mirrors/cu/CustomTkinterCustomTkinter 是基于 Tkinter 的现代化 Python UI 库其中的CTkFont与CTkImage是统一视觉体验的两个关键组件前者用像素定义字体大小、自动跟随缩放与主题后者让你一份代码同时适配浅色/深色模式。本指南面向新手带你快速掌握这两者的用法做出跨平台一致的界面。为什么要用 CTkFont 而不是原生 tkinter.font对比项tkinter.font.Fontcustomtkinter.CTkFont字号单位点pt受 DPI 影响像素直观可控窗口缩放需手动处理自动随缩放系数缩放主题切换需手动重设默认值跟随主题配置平台差异字体渲染不一致内置 Roboto 字体跨平台一致核心实现见 ctk_font.py其设计要点是size以像素为单位内部以负值传给 Tk表示像素你只需传正数如size20默认值来自主题不指定family、size时自动读取当前主题文件如 blue.json中的CTkFont配置自动参与缩放缩放系数变化时字体通过create_scaled_tuple()方法重新计算尺寸无需你写一行重绘代码。一分钟上手 CTkFont创建字体只需要一行常见参数如下参数说明可选值family字体族名字符串如Robotosize字号像素正整数如16weight字重normal/boldslant倾斜roman/italicunderline下划线True/Falseoverstrike删除线True/False用法非常简单——把字体对象传给任意控件的font参数import customtkinter app customtkinter.CTk() title customtkinter.CTkLabel( app, textCustomTkinter 标题, fontcustomtkinter.CTkFont(size20, weightbold), ) title.pack(pady20)几个实用技巧动态改字体调用font.configure(size9, overstrikeTrue)即可修改所有使用该字体的控件会同步更新参考 test_font.py 中的演示复制字体变体用font.copy()得到一份深拷贝再单独调整避免影响其他控件注意CTkFont只提供configure()不提供config()保持 API 一致性完整示例examples/complex_example.py 中侧边栏标题就使用了CTkFont(size20, weightbold)。加载自定义字体项目内置 Roboto 字体位于 customtkinter/assets/fonts/Roboto/默认界面即可跨平台保持一致观感。如需加载自己的字体文件可使用 font_manager.py 中的FontManager.load_font(font_path)Windows通过 GDI 接口AddFontResourceEx以私有方式注册字体Linux自动复制到用户字体目录~/.fonts/macOS系统已全局管理字体无需额外操作。加载成功后即可通过family参数按字体族名引用实现三端统一的字体体验。用 CTkImage 让图像适配深浅色模式ctk_image.py 提供CTkImage类它封装一个或两个PIL.Image对象light_image浅色模式下显示的图片dark_image深色模式下显示的图片size统一的显示尺寸像素随缩放系数自动调整。其中一张可以为None会自动用另一张顶替。典型用法from PIL import Image # 同一图标提供深浅两套配色 home_image customtkinter.CTkImage( light_imageImage.open(icons/home_light.png), dark_imageImage.open(icons/home_dark.png), size(20, 20), ) button customtkinter.CTkButton(app, textHome, imagehome_image, compoundleft)内部机制值得了解CTkImage会按缩放尺寸缓存ImageTk.PhotoImage见create_scaled_photo_image方法切换外观模式时自动返回对应图片且不同缩放比例下的缩放结果都被缓存性能友好。 完整可运行的图像示例见 image_example.py测试图标素材在 examples/test_images/ 目录包含home_dark.png/home_light.png等成对图标可直接参考其组织方式。背景图像CTkImage也常用作窗口背景。例如 example_background_image.py 加载 bg_gradient.jpg 作为全屏背景配合浅色文字即可获得现代感界面常见注意事项清单✅ 使用CTkFont/CTkImage前确认已安装 Pillowpip install pillow否则CTkImage会抛出ImportError✅ 浅色/深色两张图的尺寸必须一致否则_check_images校验会报ValueError✅ 字号用像素思维size16就是 16px不再需要换算 DPI✅ 图像size参数是显示尺寸源图建议比它大以保证缩放清晰度⚠️ 修改字体请使用configure()而非config()。小结CTkFont用像素定义字体并自动响应缩放与主题CTkImage用双图机制无缝适配深浅模式——掌握这两者你的 CustomTkinter 应用就能在 Windows、macOS、Linux 上呈现统一、现代的视觉。建议动手跑一遍 examples/image_example.py 和 test_font.py效果一目了然。【免费下载链接】CustomTkinterA modern and customizable python UI-library based on Tkinter项目地址: https://gitcode.com/gh_mirrors/cu/CustomTkinter创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考