Pygame添加角色动画后报TypeError: Source objects must be a surface错误求助

错误信息翻译 #

TypeError: 源对象必须是Surface

问题根源 #

1. 变量名覆盖：在Player类的初始化方法中，你先将self.image设置为Pygame Surface对象，随后又把self.image赋值为存储动画帧的字典，完全覆盖了原本的Surface类型属性。而Pygame Sprite的image属性必须是Surface对象，这是绘制时报错的核心原因。
2. 属性名拼写错误：change_animation方法中调用self.images[name]，但你实际定义的动画帧字典是self.image（正确命名应为self.images），会导致后续调用时找不到对应属性。

修正后的player.py代码 #

import pygame

class Player(pygame.sprite.Sprite):

    def __init__(self, x, y):
        super().__init__()
        self.sprite_sheet = pygame.image.load('player sheet.png')
        # 初始化默认显示的帧
        self.image = self.get_image(0 ,0)
        self.image.set_colorkey([0, 0, 0])
        self.rect = self.image.get_rect()
        
        self.position = [x, y]
        self.vitesse = 2
        # 修正变量名为self.images，避免覆盖self.image
        self.images = {
            'down' : self.get_image(0, 0),
            'left': self.get_image(0, 32),
            'right': self.get_image(0, 64),
            'up': self.get_image(0, 96)
        }
        # 给所有动画帧统一设置透明色
        for img in self.images.values():
            img.set_colorkey((0, 0, 0))

    def change_animation(self, name): 
        # 从正确的self.images字典中获取帧
        self.image = self.images[name]

    def move_right(self): self.position[0] += self.vitesse

    def  move_left(self): self.position[0] -= self.vitesse

    def move_down(self): self.position[1] += self.vitesse

    def move_up(self): self.position[1] -= self.vitesse

    def update(self):
        self.rect.topleft = self.position

    def get_image(self, x, y):
        image = pygame.Surface([32, 32])
        image.blit(self.sprite_sheet, (0, 0), (x, y, 32, 32))
        return image

额外优化说明 #

• 将动画帧字典命名为self.images，彻底和Sprite要求的self.image属性区分开，避免覆盖。
• 在初始化时统一给所有动画帧设置透明色，不用在切换动画时重复执行，提升效率。

内容的提问来源于stack exchange，提问作者Mathi'S