Mac系统PyCharm中tkinter导入图片报错的解决方法

问题原因分析 #

1. 路径格式错误：Mac采用Unix风格路径，根目录为/，你写的MainDisk/Users/...不符合Mac的路径规范——系统盘的用户目录直接从/Users开始，不需要额外添加磁盘名称MainDisk。
2. 图片格式支持限制：原生Tkinter的PhotoImage仅支持GIF、PGM、PPM、PNG（Tk 8.6及以上版本）格式，不支持JPG/JPEG，这也是可能导致失败的隐藏原因。

修复步骤 #

步骤1：修正文件路径 #

将硬编码的路径改为Mac兼容的绝对路径：

photo = tk.PhotoImage(file="/Users/Matt/PythonProjects/Car_image.jpg")

步骤2：处理JPG格式（关键） #

因为原生Tkinter不支持JPG，需要借助PIL库（Pillow）的ImageTk模块来加载：

1. 先安装Pillow：

pip install pillow

2. 修改代码加载JPG图片：

from PIL import Image, ImageTk
import tkinter as tk

root = tk.Tk()
# 加载JPG图片
image = Image.open("/Users/Matt/PythonProjects/Car_image.jpg")
photo = ImageTk.PhotoImage(image)
# 示例：将图片显示在Label上
label = tk.Label(root, image=photo)
label.image = photo  # 必须保留引用，否则图片会被垃圾回收
label.pack()

root.mainloop()

更稳健的路径写法（推荐） #

避免硬编码路径，用os模块动态生成路径，适配不同系统：

import os
from PIL import Image, ImageTk
import tkinter as tk

root = tk.Tk()
# 获取用户主目录（Mac和Windows都适用）
home_dir = os.path.expanduser("~")
# 拼接图片路径
image_path = os.path.join(home_dir, "PythonProjects", "Car_image.jpg")
# 加载图片
image = Image.open(image_path)
photo = ImageTk.PhotoImage(image)

label = tk.Label(root, image=photo)
label.image = photo
label.pack()

root.mainloop()

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