Pygame自定义图片按钮报错：'pygame.Surface'无collidepoint属性

原本用pygame.Rect创建按钮能正常工作，改成自定义图片按钮后运行报错：

AttributeError: 'pygame.Surface' object has no attribute 'collidepoint'

当前代码：

def main_menu():
    while True:
        #menu background
        menu_background = pygame.image.load('game graphics/menu.png')
        menu_background = pygame.transform.scale(menu_background, (screen_w,screen_h)).convert()
        screen.blit(menu_background,(0,0))
        #menu buttons
        mx, my = pygame.mouse.get_pos()
        
        play_button = pygame.image.load('game graphics/play_button.png').convert_alpha()
        play_button = pygame.transform.scale(play_button, (400,300))
        # play_button = pygame.Rect(50,100,200,50)
        screen.blit(play_button,(-50,200))
        
        
        if play_button.collidepoint((mx,my)):
            if click:
                game()

错误原因 #

你现在把play_button赋值成了Pygame Surface对象（即加载的图片），而collidepoint是pygame.Rect类独有的碰撞检测方法，Surface对象没有这个属性，因此触发报错。

实现图片按钮需要分开处理：

• Surface对象负责显示按钮图片
• Rect对象负责记录按钮的位置、尺寸，用来做鼠标碰撞检测

修改后的代码 #

def main_menu():
    # 资源加载移到循环外，避免重复读取卡顿
    menu_background = pygame.image.load('game graphics/menu.png')
    menu_background = pygame.transform.scale(menu_background, (screen_w,screen_h)).convert()
    
    play_button = pygame.image.load('game graphics/play_button.png').convert_alpha()
    play_button = pygame.transform.scale(play_button, (400,300))
    # 创建与图片尺寸匹配的Rect，指定左上角位置
    play_button_rect = play_button.get_rect(topleft=(-50, 200))
    
    while True:
        # 处理事件，修复点击逻辑
        click = False
        for event in pygame.event.get():
            if event.type == pygame.QUIT:
                pygame.quit()
                exit()
            if event.type == pygame.MOUSEBUTTONDOWN and event.button == 1:
                click = True
        
        # 绘制背景和按钮
        screen.blit(menu_background,(0,0))
        screen.blit(play_button, play_button_rect)
        
        # 用Rect做碰撞检测
        mx, my = pygame.mouse.get_pos()
        if play_button_rect.collidepoint((mx,my)) and click:
            game()
        
        pygame.display.update()

关键修改点 #

1. 将图片、背景的加载/缩放操作移到主循环外，避免重复读取资源，提升运行性能
2. 通过play_button.get_rect()创建与图片尺寸完全匹配的Rect对象，用topleft参数指定按钮显示位置，和原代码blit坐标一致
3. 碰撞检测时调用Rect对象的collidepoint方法，而非Surface对象
4. 补充完整的事件循环处理点击事件，修复原代码中click变量无赋值逻辑的问题

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