Pygame图像按钮跨菜单界面误触发点击穿透问题

点击穿透是两个逻辑问题叠加导致的：

1. 菜单状态判断用连续if而非互斥分支，同一帧内点击选项菜单的音频按钮切换到Audio菜单状态后，代码会继续往下执行音频菜单的按钮检测逻辑
2. 按钮类的点击判断用实时鼠标按下状态pygame.mouse.get_pressed()，而非监听鼠标点击事件，同一帧内鼠标保持按下状态时，新显示的同位置下层按钮会直接判定为被点击，触发误操作。

分两步修改，从根源解决穿透问题。

第一步：重写按钮类点击判定逻辑 #

把实时检测鼠标按下的逻辑，改成响应鼠标抬起事件，避免同一帧状态切换时的误触发，修改后的button.py代码：

import pygame

class Button():
    def __init__(self, x, y, image, scale):
        width = image.get_width()
        height = image.get_height()
        self.image = pygame.transform.scale(image, (int(width * scale), int(height * scale)))
        self.rect = self.image.get_rect()
        self.rect.topleft = (x, y)

    def draw(self, surface, mouse_up_pos=None):
        action = False
        # 仅当传入鼠标抬起位置、且位置在按钮范围内时触发点击
        if mouse_up_pos and self.rect.collidepoint(mouse_up_pos):
            action = True
        # 绘制按钮
        surface.blit(self.image, (self.rect.x, self.rect.y))
        return action

第二步：调整主循环逻辑 #

1. 把菜单状态判断的连续if改成elif互斥分支，保证同一帧只会执行当前激活菜单的按钮逻辑，不会跨菜单运行检测
2. 在事件循环中捕获鼠标左键抬起事件，把点击位置传给对应菜单的按钮做检测
   修改后的主循环代码：

import button
import pygame

pygame.init()

# 创建游戏窗口
SCREEN_WIDTH = 800
SCREEN_HEIGHT = 600

bg_img = pygame.image.load("D:\Python\Projects\Second_menu\yper_saber_no_buttons.png")
bg_img = pygame.transform.scale(bg_img,(SCREEN_WIDTH, SCREEN_HEIGHT))

screen = pygame.display.set_mode((SCREEN_WIDTH, SCREEN_HEIGHT))
pygame.display.set_caption("Main Menu")

pygame.mixer.init()
pygame.mixer.music.load("D:\Python\Projects\main_menu\High_Contrast_-_If_We_Ever.wav")
pygame.mixer.music.play(loops=-1)

# 游戏变量
game_paused = True
menu_state = "main"
mouse_click_pos = None  # 存储当前帧鼠标左键抬起位置


# 定义字体
font = pygame.font.SysFont("arialblack", 40)

# 定义颜色
TEXT_COL = (255, 255, 255)

# 加载按钮图片
start_img = pygame.image.load("D:\Python\Projects\Second_menu\Start_Button.png").convert_alpha()
options_img = pygame.image.load("D:\Python\Projects\Second_menu\Options_Button.png").convert_alpha()
quit_img = pygame.image.load("D:\Python\Projects\second_menu\Quit_Button.png").convert_alpha()
controls_img = pygame.image.load("D:\Python\Projects\second_menu\Controls_Button.png").convert_alpha()
audio_img = pygame.image.load("D:\Python\Projects\second_menu\Audio_Button.png").convert_alpha()
video_settings_img = pygame.image.load("D:\Python\Projects\Second_menu\Video_settings_Button.png").convert_alpha()
mute_menu_music_img = pygame.image.load("D:\Python\Projects\Second_menu\Mute_menu_music_Button.png").convert_alpha()
back_img = pygame.image.load("D:\Python\Projects\second_menu\Back_Button.png").convert_alpha()

# 创建按钮实例
start_button = button.Button(328, 380, start_img, 1)
options_button = button.Button(325, 435, options_img, 1)
quit_button = button.Button(355, 485, quit_img, 1)
# 选项菜单按钮
controls_button = button.Button(304, 373, controls_img, 1)
audio_button = button.Button(304, 473, audio_img, 1)
Video_settings_Button = button.Button(304 ,423, video_settings_img, 1) 
back_button = button.Button(355, 530, back_img, 1)
# 音频菜单按钮
mute_menu_music_button = button.Button (350, 473, mute_menu_music_img, 1)


# 游戏主循环
run = True
while run:
    mouse_click_pos = None  # 每帧重置点击状态
    screen.blit(bg_img,(0,0))

    if game_paused == True:
        # 用elif做互斥分支，同一帧仅运行当前菜单逻辑
        if menu_state == "main":
            if start_button.draw(screen, mouse_click_pos):
                game_paused = False
            if options_button.draw(screen, mouse_click_pos):
                menu_state = "options"
            if quit_button.draw(screen, mouse_click_pos):
                run = False
        elif menu_state == "options":
            if controls_button.draw(screen, mouse_click_pos):
                print("Controls")
            if audio_button.draw(screen, mouse_click_pos):
                menu_state = "Audio"
            if Video_settings_Button.draw(screen, mouse_click_pos):
                print("Video settings")
            if back_button.draw(screen, mouse_click_pos):
                menu_state = "main"
        # 控制菜单待开发 **TO DO**
        elif menu_state == "Audio":
            if mute_menu_music_button.draw(screen, mouse_click_pos):
                pygame.mixer.music.pause()
            # 补全音频菜单返回逻辑
            if back_button.draw(screen, mouse_click_pos):
                menu_state = "options"

    # 事件处理
    for event in pygame.event.get():
        if event.type == pygame.KEYDOWN:
            if event.key == pygame.K_SPACE:
                game_paused = True
        if event.type == pygame.MOUSEBUTTONUP and event.button == 1:
            # 鼠标左键抬起时记录点击位置
            mouse_click_pos = event.pos
        if event.type == pygame.QUIT:
            run = False

    pygame.display.update()

pygame.quit()

• 后续新增子菜单时，统一用elif承接菜单状态判断，不要单独写if，避免跨菜单逻辑穿透
• 用鼠标抬起事件判定点击更符合常规UI交互逻辑：用户按下鼠标后如果拖到按钮外再松开，不会触发点击，交互体验更好
• 可以给静音按钮加状态切换逻辑，点一次静音、再点一次恢复声音，完善功能

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