pygame游戏中如何检测hitbox碰撞并解决单次碰撞多次触发问题

问题原因 #

你当前的碰撞检测逻辑写在游戏主循环内，会以60次/秒的频率逐帧执行，只要玩家和敌人的碰撞矩形处于重叠状态，每帧都会触发一次打印操作，所以单次碰撞过程会输出大量重复内容。另外你原有代码将碰撞检测放在事件遍历循环内，只有系统触发事件时才会执行碰撞检测，逻辑位置存在错误，同时冗余调用了pygame.display.update()和pygame.display.flip()，保留后者即可。

解决方案 #

最常用的实现方式是给碰撞对象新增碰撞状态标记，只有第一次检测到碰撞且状态为未触发时才执行对应逻辑，碰撞结束后重置状态即可，以下是修改后的代码示例：

第一步：给自定义类新增碰撞状态属性 #

class Player(pygame.sprite.Sprite):
    def __init__(self):
        super().__init__()
        # 保留你原有的初始化代码
        self.has_collided = False # 新增碰撞状态标记，默认未碰撞

第二步：修改主循环逻辑 #

running = True
while running:
    clock.tick(60)

    for event in pygame.event.get():
        if event.type == pygame.QUIT:
            running = False
            pygame.quit()
        # 其他事件处理逻辑

    # 碰撞检测移到事件循环外，每帧正常执行
    for player in player_list:
        collide = player.rect.colliderect(enemy)
        if collide and not player.has_collided:
            print("hit")
            # 此处可替换为你自定义的碰撞触发逻辑
            player.has_collided = True # 标记为已触发碰撞，后续重叠不会重复执行
        # 碰撞结束后重置状态
        elif not collide and player.has_collided:
            player.has_collided = False

    # 原有渲染逻辑
    win.blit(bg, (0,0))
    player.update()
    enemy.update()
    enemy_list.draw(win)
    player_list.draw(win)
    pygame.display.flip()

其他可选方案 #

• 如果你碰撞后需要销毁敌人/玩家对象，直接调用对象的kill()方法即可，对象从精灵组移除后不会再参与碰撞检测，自然不会重复触发
• 如果是多敌人碰撞场景，可以用pygame.sprite.spritecollide()方法，设置dokill参数为True直接销毁碰撞到的敌人，也可以避免重复触发

内容的提问来源于stack exchange，提问作者SplatÄnti