基于 Pygame 的水果忍者小游戏实现教程

关键点解析：

• pygame.init()：初始化所有导入的 Pygame 模块。
• set_mode：设置窗口大小和模式，返回 Surface 对象用于后续绘制。
• Clock：用于控制游戏循环的帧率，防止程序运行过快导致 CPU 占用过高。
• 异常处理：在加载资源时增加 try-except 块，防止因缺少图片导致程序崩溃。

四、游戏对象与数据管理

我们需要定义数据结构来存储游戏中各个元素的状态，例如水果的位置、速度、是否被击中等信息。

# 全局变量初始化
score = 0
player_lives = 3
data = {}  # 存储所有水果对象的数据
game_over = False
first_round = True
fruits = ['apple', 'orange', 'banana']  # 可切割的水果列表

def generate_random_fruits(fruit_type):
    """
    生成随机位置的水果对象
    :param fruit_type: 水果类型名称
    """
    fruit_path = f"images/{fruit_type}.png"
    # 检查图片是否存在，不存在则跳过
    if not os.path.exists(fruit_path):
        return
        
    data[fruit_type] = {
        'img': pygame.image.load(fruit_path),
        'x': random.randint(100, WIDTH - 100),
        'y': HEIGHT + 50,
        'speed_x': random.randint(-5, 5),
        'speed_y': random.randint(-10, -5),
        'throw': False,
        't': 0,  # 时间计数器，用于模拟重力
        'hit': False,  # 是否已被切割
        'type': fruit_type
    }
    
    # 75% 概率抛出水果
    if random.random() >= 0.25:
        data[fruit_type]['throw'] = True
    else:
        data[fruit_type]['throw'] = False

# 初始化所有水果对象
for fruit in fruits:
    generate_random_fruits(fruit)

逻辑说明：

• data 字典采用键值对形式，key 为水果类型，value 为包含坐标、速度、图像引用的字典。
• speed_y 设为负值表示向上运动，配合 t 变量模拟抛物线轨迹。
• throw 标志位控制该水果是否参与当前帧的运动更新。

五、UI 绘制函数

为了提升用户体验，需要绘制分数、生命值和游戏结束提示。

def draw_text(display, text, size, x, y, color=WHITE):
    """
    在指定位置绘制文字
    """
    font = pygame.font.Font(font_name, size)
    text_surface = font.render(text, True, color)
    text_rect = text_surface.get_rect()
    text_rect.midtop = (x, y)
    display.blit(text_surface, text_rect)

def draw_lives(display, x, y, lives, image_path):
    """
    绘制玩家剩余生命值图标
    """
    for i in range(lives):
        try:
            img = pygame.image.load(image_path)
            img_rect = img.get_rect()
            img_rect.x = int(x + 35 * i)
            img_rect.y = y
            display.blit(img, img_rect)
        except FileNotFoundError:
            pass

def hide_cross_lives(x, y):
    """
    隐藏特定位置的生命值图标（用于减少生命值时的视觉效果）
    """
    try:
        gameDisplay.blit(pygame.image.load("images/red_lives.png"), (x, y))
    except FileNotFoundError:
        pass

def show_gameover_screen():
    """
    显示游戏结束画面
    """
    global score
    gameDisplay.blit(background, (0, 0))
    draw_text(gameDisplay, "GAME OVER", 90, WIDTH / 2, HEIGHT / 4, RED)
    draw_text(gameDisplay, f"Score : {score}", 50, WIDTH / 2, HEIGHT / 2, WHITE)
    draw_text(gameDisplay, "Press a key to restart!", 32, WIDTH / 2, HEIGHT * 3 / 4, WHITE)
    pygame.display.flip()
    waiting = True
    while waiting:
        clock.tick(FPS)
        for event in pygame.event.get():
            if event.type == pygame.QUIT:
                pygame.quit()
                sys.exit()
            if event.type == pygame.KEYUP:
                waiting = False

六、游戏主循环与逻辑控制

这是游戏的核心部分，负责处理输入事件、更新游戏状态和渲染画面。

while True:
    # 1. 事件处理
    for event in pygame.event.get():
        if event.type == pygame.QUIT:
            pygame.quit()
            sys.exit()
        elif event.type == pygame.MOUSEBUTTONDOWN:
            # 获取鼠标点击位置
            mouse_pos = pygame.mouse.get_pos()
            # 遍历所有水果进行碰撞检测
            for key, value in list(data.items()):
                if value['throw'] and not value['hit']:
                    rect = value['img'].get_rect(topleft=(value['x'], value['y']))
                    # 简单的矩形碰撞检测
                    if rect.collidepoint(mouse_pos):
                        handle_hit(key, value, mouse_pos)

    # 2. 游戏状态重置
    if game_over:
        if first_round:
            show_gameover_screen()
            first_round = False
        game_over = False
        player_lives = 3
        score = 0
        data.clear()
        for fruit in fruits:
            generate_random_fruits(fruit)

    # 3. 清空屏幕
    gameDisplay.blit(background, (0, 0))

    # 4. 更新与绘制水果
    for key, value in data.items():
        if value['throw']:
            # 物理模拟：重力加速度
            value['speed_y'] += 0.5
            value['x'] += value['speed_x']
            value['y'] += value['speed_y']
            value['t'] += 1

            # 边界检查：超出屏幕底部则重新生成
            if value['y'] > HEIGHT + 50:
                value['throw'] = False
                generate_random_fruits(key)
            else:
                gameDisplay.blit(value['img'], (value['x'], value['y']))

    # 5. 绘制 UI
    score_text = font.render(f'Score : {score}', True, WHITE)
    gameDisplay.blit(score_text, (10, 10))
    draw_lives(gameDisplay, WIDTH - 150, 10, player_lives, 'images/red_lives.png')

    # 6. 游戏结束判断
    if player_lives <= 0:
        game_over = True

    pygame.display.update()
    clock.tick(FPS)

辅助函数补充： 为了完善上述主循环，需要补充 handle_hit 函数来处理切割逻辑：

def handle_hit(fruit_key, fruit_data, pos):
    global score, player_lives
    if fruit_key == 'bomb':
        player_lives -= 1
        # 播放爆炸音效（如有）
    else:
        score += 1
        # 切换为半切图片
        half_path = f"images/half_{fruit_key}.png"
        if os.path.exists(half_path):
            fruit_data['img'] = pygame.image.load(half_path)
        fruit_data['hit'] = True

七、优化与扩展建议

完成基础功能后，可以从以下几个方面进一步优化游戏体验：

1. 性能优化：对于大量水果场景，建议使用对象池技术复用 Sprite 对象，减少频繁创建销毁带来的内存开销。
2. 音效增强：添加切割声、爆炸声和背景音乐，使用 pygame.mixer 模块实现。
3. 难度递增：随着分数提高，逐渐增加水果抛出的速度和频率，提升挑战性。
4. 多关卡设计：引入关卡系统，每达到一定分数进入下一关，改变背景或规则。
5. 移动端适配：如果目标平台包含移动设备，需将鼠标事件转换为触摸事件处理。

八、总结

本文详细介绍了使用 Python 和 Pygame 开发水果忍者小游戏的完整过程。从窗口初始化、资源加载到核心的游戏循环与碰撞检测，涵盖了 2D 游戏开发的基础知识。通过阅读和修改本项目的代码，学习者可以掌握事件驱动编程的基本模式，并为后续开发更复杂的游戏打下坚实基础。

建议在本地环境中实际运行代码，并根据自身需求调整参数（如速度、分数权重等），以加深理解。