Pygame加载图片报错‘Unsupported image format’问题求助

可能的报错原因 #

1. 代码缩进错误：你的import_folder函数中，遍历文件夹的for循环和return语句未缩进，导致这部分逻辑不在函数内部。调用函数时不会执行图片加载代码，或运行时逻辑混乱引发异常。
2. 文件路径拼接错误：直接用path + '/' + image_name拼接路径，既无法适配Windows等系统的路径分隔符（\），也无法处理walk遍历子文件夹的情况——此时image_name属于子文件夹，用原始path拼接会得到错误路径，可能加载到非目标文件。
3. 加载了非图片文件：walk会遍历文件夹内所有文件，包括隐藏文件（如Mac的.DS_Store、Windows的Thumbs.db）或临时文件，这些文件不是图片格式，pygame.image.load无法识别就会报错。
4. 图片文件本身有问题：即使修改了扩展名，若文件本身损坏，或者扩展名与实际格式不匹配（比如把文本文件改名为.jpg），pygame也无法识别。

对应解决办法 #

1. 修复代码缩进 #

将for循环和return语句缩进，确保它们属于import_folder函数的逻辑：

import pygame
from os import walk

def import_folder(path):
    surface_list = []

    for folder_name, sub_folders, img_files in walk(path):
        for image_name in img_files:
            full_path = path + '/' + image_name
            image_surf = pygame.image.load(full_path)
            surface_list.append(image_surf)
    return surface_list 

def import_folder_dict(path):
    pass 

2. 正确拼接文件路径 #

使用os.path.join拼接路径，适配不同操作系统，同时结合walk返回的folder_name（当前遍历的文件夹完整路径）确保路径正确：

import pygame
import os
from os import walk

def import_folder(path):
    surface_list = []

    for folder_name, sub_folders, img_files in walk(path):
        for image_name in img_files:
            full_path = os.path.join(folder_name, image_name)
            image_surf = pygame.image.load(full_path)
            surface_list.append(image_surf)
    return surface_list 

3. 过滤非图片文件 #

只处理指定扩展名的图片文件，避免加载无关文件：

import pygame
import os
from os import walk

def import_folder(path):
    surface_list = []
    # 定义pygame支持的图片扩展名
    valid_extensions = ('.png', '.jpg', '.jpeg', '.bmp', '.gif')

    for folder_name, sub_folders, img_files in walk(path):
        for image_name in img_files:
            if image_name.lower().endswith(valid_extensions):
                full_path = os.path.join(folder_name, image_name)
                image_surf = pygame.image.load(full_path)
                surface_list.append(image_surf)
    return surface_list 

4. 检查图片文件 #

• 用图片查看器打开图片，确认文件能正常显示、无损坏。
• 验证文件扩展名与实际格式一致，不要用扩展名伪装文件类型。

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