CustomTkinter中CTkButton自定义图片设置（解决图片不存在错误）

问题根源 #

CustomTkinter的CTkButton组件的image参数不支持直接传入图片路径字符串，必须先将图片转换为CustomTkinter专用的CTkImage对象才能正常使用。

修复步骤及代码示例 #

1. 导入CTkImage类（CustomTkinter内置的图片处理类）
2. 用CTkImage.load()方法加载图片文件，生成CTkImage对象
3. 将该对象传入按钮的image参数

完整示例代码：

import customtkinter
from customtkinter import CTkImage

def button_callback():
    print("按钮触发回调")

app = customtkinter.CTk()

# 加载图片：需区分明暗模式（若无需区分，两张图传相同路径即可）
# size参数可按需调整图片尺寸，适配按钮大小
btn_image = CTkImage(
    light_image=CTkImage.load("xyz.png"),
    dark_image=CTkImage.load("xyz.png"),
    size=(24, 24)
)

# 创建按钮时传入CTkImage对象
button = customtkinter.CTkButton(
    app,
    text="xyz",
    image=btn_image,
    command=button_callback
)
button.pack(padx=20, pady=20)

app.mainloop()

额外排查要点 #

• 路径验证：先用import os; print(os.path.exists("xyz.png"))检查图片路径是否正确，避免文件名拼写错误或文件不在脚本同目录下
• 格式支持：CustomTkinter支持PNG、ICO格式，不支持SVG，别用SVG格式测试
• 明暗模式适配：如果你的应用启用了明暗模式切换，可分别传入对应模式的图片；若不需要，两个参数传同一张图即可

内容的提问来源于stack exchange，提问作者5Green_on_python