如何实现Pygame按钮仅触发一次点击动作？

你的问题很典型——这是因为pygame.mouse.get_pressed()会在鼠标左键按住的每一个游戏循环帧都返回True，所以只要按住按钮不松手，action()就会被反复调用。要让操作只执行一次，核心是只在鼠标按下的瞬间触发，而不是按住的整个过程。下面给你几种实用的修改方案：

方案一：用PyGame事件队列（推荐） #

PyGame的事件系统专门用来处理单次输入（比如点击、按键按下），MOUSEBUTTONDOWN事件只会在鼠标按下的那一刻触发一次，完美解决重复调用的问题。

修改后的函数（配合主循环事件处理） #

def action_button(x,y,w,h,ic,ac,text, text_colour,action=None, events=None):
    mouse = pygame.mouse.get_pos()
    clicked = False

    # 从传入的事件列表中检测单次点击
    if events is not None:
        for event in events:
            if event.type == pygame.MOUSEBUTTONDOWN and event.button == 1:
                # 检查点击位置是否在按钮范围内
                if x < mouse[0] < x+w and y < mouse[1] < y+h:
                    clicked = True

    # 绘制按钮状态
    if x+w > mouse[0] > x and y+h > mouse[1] > y:
        pygame.draw.rect(screen, ac,(x,y,w,h))
        if clicked and action is not None:
            action()
    else:
        pygame.draw.rect(screen, ic,(x,y,w,h))

    # 优化文本绘制（用center定位更简洁）
    font = pygame.font.SysFont("arial black",20)
    text_surf = font.render(text,True,(text_colour))
    text_rect = text_surf.get_rect(center=(x + w//2, y + h//2))
    screen.blit(text_surf, text_rect)

主循环中调用方式 #

running = True
while running:
    # 先收集所有事件，避免重复处理
    events = pygame.event.get()
    for event in events:
        if event.type == pygame.QUIT:
            running = False
    
    screen.fill((0,0,0))
    # 传入events参数给按钮函数
    action_button(100,100,200,50,(200,200,200),(100,100,100),"点击我",(255,255,255),lambda: print("只触发一次！"), events)
    pygame.display.flip()

方案二：跟踪鼠标状态（无需改事件处理） #

如果不想调整主循环的事件逻辑，可以通过记录上一帧的鼠标状态，只在“从松开到按下”的瞬间触发操作。

修改后的函数 #

# 全局变量记录上一帧的左键状态（如果有多个按钮，建议用类封装状态）
last_mouse_left = False

def action_button(x,y,w,h,ic,ac,text, text_colour,action=None):
    global last_mouse_left
    mouse = pygame.mouse.get_pos()
    click = pygame.mouse.get_pressed()
    
    # 对比当前和上一帧的状态，判断是否是首次按下
    current_left = click[0] == 1
    clicked = current_left and not last_mouse_left
    # 更新上一帧状态
    last_mouse_left = current_left

    # 绘制按钮和触发逻辑
    if x+w > mouse[0] > x and y+h > mouse[1] > y:
        pygame.draw.rect(screen, ac,(x,y,w,h))
        if clicked and action is not None:
            action()
    else:
        pygame.draw.rect(screen, ic,(x,y,w,h))

    # 文本绘制
    font = pygame.font.SysFont("arial black",20)
    text_surf = font.render(text,True,(text_colour))
    text_rect = text_surf.get_rect(center=(x + w//2, y + h//2))
    screen.blit(text_surf, text_rect)

方案三：面向对象封装（适合多按钮场景） #

如果你的项目有多个按钮，用类来封装每个按钮的状态会更优雅，避免全局变量的混乱：

Button类实现 #

class Button:
    def __init__(self, x, y, w, h, ic, ac, text, text_colour, action=None):
        self.x = x
        self.y = y
        self.w = w
        self.h = h
        self.ic = ic
        self.ac = ac
        self.text = text
        self.text_colour = text_colour
        self.action = action
        self.last_mouse_left = False  # 每个按钮自己管理状态

    def draw(self, screen):
        mouse = pygame.mouse.get_pos()
        click = pygame.mouse.get_pressed()
        
        current_left = click[0] == 1
        clicked = current_left and not self.last_mouse_left
        self.last_mouse_left = current_left

        # 绘制按钮
        if self.x < mouse[0] < self.x + self.w and self.y < mouse[1] < self.y + self.h:
            pygame.draw.rect(screen, self.ac, (self.x, self.y, self.w, self.h))
            if clicked and self.action is not None:
                self.action()
        else:
            pygame.draw.rect(screen, self.ic, (self.x, self.y, self.w, self.h))

        # 绘制文本
        font = pygame.font.SysFont("arial black",20)
        text_surf = font.render(self.text, True, self.text_colour)
        text_rect = text_surf.get_rect(center=(self.x + self.w//2, self.y + self.h//2))
        screen.blit(text_surf, text_rect)

使用方式 #

# 创建按钮实例
my_button = Button(100,100,200,50,(200,200,200),(100,100,100),"点击我",(255,255,255),lambda: print("只触发一次！"))

running = True
while running:
    for event in pygame.event.get():
        if event.type == pygame.QUIT:
            running = False
    
    screen.fill((0,0,0))
    my_button.draw(screen)
    pygame.display.flip()

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