Tkinter中使用透明PNG图片作为按钮时出现灰底/空白如何解决

问题原因 #

• 你两次调整代码写法都没有改善效果，核心原因是Tkinter原生Button组件自带系统主题渲染的不透明背景、边框，无论你是初始化时传入image参数还是后续用config设置图片，组件本身的灰色底色都会显示在图片透明区域下方，和代码写法顺序无关。
• 参考方案操作后图片空白，基本都是两个原因：一是图片对象被垃圾回收没有保留引用，二是方案参数和你本地运行环境、图片格式不匹配。

可行解决方案 #

方案1：无额外依赖，用Canvas实现透明按钮

不需要安装第三方库，完全避开原生Button的自带背景问题，直接在画布上渲染透明图片，绑定点击事件实现按钮功能，适合新手快速实现效果：

from tkinter import Tk, PhotoImage

win = Tk()
win.geometry("500x500")

def on_gun_click():
    # 这里写按钮点击后要执行的逻辑
    print("按钮被点击")

def play():
    Gun = PhotoImage(file='Gun.png')
    # 创建无框、无高亮边的画布，尺寸和图片一致
    gun_btn = win.Canvas(
        width=Gun.width(),
        height=Gun.height(),
        bd=0,
        highlightthickness=0
    )
    # 将透明图片绘制到画布左上角
    gun_btn.create_image(0, 0, image=Gun, anchor="nw")
    # 必须保留图片引用，否则会被垃圾回收导致显示空白
    gun_btn.image = Gun
    # 绑定鼠标左键点击事件
    gun_btn.bind("<Button-1>", lambda e: on_gun_click())
    gun_btn.place(x=100, y=100)

play()
win.mainloop()

注意：这个方案要求你的Gun.png是带Alpha透明通道的32位真彩色PNG，不要用系统画图工具另存的256色索引PNG，否则透明通道会失效。

方案2：适配复杂交互，用Pillow+ttk实现透明按钮

如果需要按钮悬停、点击的状态反馈，或者想要更好的图片格式兼容性，先安装Pillow库，在终端执行命令：
pip install pillow
参考代码如下：

from tkinter import Tk, ttk
from PIL import Image, ImageTk

win = Tk()
win.geometry("500x500")

def on_gun_click():
    print("按钮被点击")

def play():
    # 用Pillow加载PNG，兼容更多格式的透明图片
    pil_gun = Image.open("Gun.png").convert("RGBA")
    Gun = ImageTk.PhotoImage(pil_gun)
    # 配置ttk按钮样式，完全移除默认边框、背景
    btn_style = ttk.Style()
    btn_style.configure(
        "TransparentBtn.TButton",
        borderwidth=0,
        relief="flat",
        background=win.cget("background")
    )
    GunButton = ttk.Button(
        win,
        image=Gun,
        style="TransparentBtn.TButton",
        command=on_gun_click
    )
    # 保留图片引用防止被回收
    GunButton.image = Gun
    GunButton.place(x=100, y=100)

play()
win.mainloop()

常见踩坑提醒 #

• 图片对象不要只定义成函数内的局部变量，必须绑定到组件属性或者设为全局变量，否则函数运行结束后图片会被Python自动回收，出现显示空白的问题。
• Windows系统下不要尝试给原生Button设置透明背景，系统主题会强制给按钮渲染点击、焦点状态的色块，无法实现真正的透明效果。

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