Pygame按钮点击异常：首个按钮可响应，第二个无反应求助

问题描述 #

使用Python和Pygame开发游戏时，自定义Button类并创建两个按钮实例后出现以下异常：

• 两个按钮的鼠标悬停变暗效果正常
• 仅第一个被处理的按钮能响应点击事件；调整按钮处理顺序后，原第二个按钮可正常响应，原第一个失效
• 新建测试文件复用相同代码，问题依然复现

简化测试代码如下：

import pygame

class Button:
    def __init__(self, x, y, width, height, color, hover_color, click_func):
        self.rect = pygame.Rect(x, y, width, height)
        self.color = color
        self.hover_color = hover_color
        self.display_color = self.color
        self.click_func = click_func

    def process(self):
        events = pygame.event.get()
        mouse_pos = pygame.mouse.get_pos()
        if self.rect.collidepoint(mouse_pos):
            self.display_color = self.hover_color
            for event in events:
                if event.type == pygame.MOUSEBUTTONDOWN:
                    self.click_func()

        else:
            self.display_color = self.color

def press_func1():
    print('press func 1')

def press_func2():
    print('press func 2')


WIN = pygame.display.set_mode((500, 500))

buttons = [
    Button(200, 100, 100, 50, (255, 0, 0), (150, 0, 0), press_func1),
    Button(200, 300, 100, 50, (0, 255, 0), (0, 150, 0), press_func2)
]
    
running = True
fps = pygame.time.Clock()
while running:
    fps.tick(60)
        
    WIN.fill((255, 255, 255))
    
    [button.process() for button in buttons]
    [pygame.draw.rect(WIN, button.display_color, button.rect) for button in buttons]
        
    pygame.display.update()

问题原因 #

核心问题出在Button.process()方法内的pygame.event.get()调用：

• Pygame的事件队列是一次性消费机制：每次调用pygame.event.get()会清空队列中所有事件并返回它们
• 第一个按钮执行process()时，已将点击事件从队列中取走；后续按钮调用process()时，事件队列已为空，无法检测到点击事件
• 悬停效果不受影响是因为pygame.mouse.get_pos()直接读取当前鼠标位置，不需要依赖事件队列，每个按钮可独立检测

修复方案 #

将事件获取逻辑移至主循环中，统一获取一次事件后传递给所有按钮处理，避免事件被提前消费：

修改后的代码示例：

import pygame

class Button:
    def __init__(self, x, y, width, height, color, hover_color, click_func):
        self.rect = pygame.Rect(x, y, width, height)
        self.color = color
        self.hover_color = hover_color
        self.display_color = self.color
        self.click_func = click_func

    def process(self, events):  # 接收主循环传递的事件列表
        mouse_pos = pygame.mouse.get_pos()
        if self.rect.collidepoint(mouse_pos):
            self.display_color = self.hover_color
            for event in events:
                if event.type == pygame.MOUSEBUTTONDOWN:
                    self.click_func()

        else:
            self.display_color = self.color

def press_func1():
    print('press func 1')

def press_func2():
    print('press func 2')


WIN = pygame.display.set_mode((500, 500))

buttons = [
    Button(200, 100, 100, 50, (255, 0, 0), (150, 0, 0), press_func1),
    Button(200, 300, 100, 50, (0, 255, 0), (0, 150, 0), press_func2)
]
    
running = True
fps = pygame.time.Clock()
while running:
    fps.tick(60)
    events = pygame.event.get()  # 主循环统一获取事件
    
    # 补充退出事件处理，修复原代码无法关闭窗口的问题
    for event in events:
        if event.type == pygame.QUIT:
            running = False
        
    WIN.fill((255, 255, 255))
    
    [button.process(events) for button in buttons]  # 传递事件给每个按钮
    [pygame.draw.rect(WIN, button.display_color, button.rect) for button in buttons]
        
    pygame.display.update()

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