WSL Ubuntu环境下Tkinter应用图标无法正常显示求助

问题原因 #

WSL作为Linux子系统，Tkinter的图标处理逻辑与原生Windows存在差异：

• iconbitmap方法仅支持Linux原生的XBM位图格式，不兼容Windows的ICO格式，因此调用会报错。
• 原生Tkinter的PhotoImage对PNG格式的支持在WSL环境中存在兼容性问题，导致加载后显示空图标。
• 部分XServer配置可能限制了窗口图标的渲染。

解决方案 #

方案1：使用PIL库加载PNG图标 #

借助PIL（Pillow）库的ImageTk模块，能更好地兼容Linux环境下的图片格式，步骤如下：

1. 安装Pillow库：

sudo apt update && sudo apt install python3-pil python3-pil.imagetk

2. 修改代码：

import tkinter as tk
from PIL import Image, ImageTk

root = tk.Tk()

# 加载图片并保存引用（避免被垃圾回收）
img = Image.open("./logo.png")
tk_img = ImageTk.PhotoImage(img)

# 设置窗口图标
root.iconphoto(False, tk_img)

root.mainloop()

方案2：使用Linux原生XBM格式图标 #

将ICO或PNG转换为XBM格式（可在线转换或用ImageMagick工具），然后使用iconbitmap：

1. 安装ImageMagick（可选，用于格式转换）：

sudo apt install imagemagick

2. 转换图片：

convert logo.png icon.xbm

3. 修改代码：

import tkinter as tk

root = tk.Tk()

root.iconbitmap('./icon.xbm')

root.mainloop()

方案3：检查XServer配置 #

确保你使用的XServer（如VcXsrv、X410）配置正确：

• 启动XServer时勾选「Disable access control」选项，允许WSL进程访问。
• 确保DISPLAY环境变量正确设置（可通过echo $DISPLAY验证，WSL通常会自动配置）。

内容的提问来源于stack exchange，提问作者Abel Gutiérrez