当前位置：首页 > news >正文

Python游戏开发入门：用Pygame实现横版跑酷游戏

news 2026/7/29 9:14:03

1. 项目概述：从零到一，用Python和Pygame打造你的第一款“忍者猫”游戏

如果你刚学完Python基础语法，正愁找不到一个有趣的项目来练手，或者你是个游戏爱好者，一直好奇那些简单的2D游戏是怎么做出来的，那么今天这个“忍者猫”游戏项目就是为你量身定做的。这个项目的核心目标非常明确：用Python的Pygame库，实现一个玩家控制忍者猫角色，在场景中不断前进，通过跳跃或下蹲来躲避障碍物，同时收集硬币来获取分数，并尽可能跑得更远的横版过关游戏。听起来是不是很像经典的《T-Rex Runner》（Chrome断网小恐龙）或者一些早期的横版跑酷游戏？没错，它的核心玩法逻辑就是如此经典且迷人。

为什么选择这个项目作为你的第一个游戏开发实践呢？首先，它麻雀虽小，五脏俱全。一个完整的游戏所必需的几个核心模块——游戏循环、事件处理、精灵（角色与物体）管理、碰撞检测、分数系统、游戏状态管理——在这个项目中你都会亲手实现一遍。其次，Pygame库对初学者极其友好，它用相对直观的方式封装了底层图形、声音和事件处理，让你能更专注于游戏逻辑本身，而不是被复杂的API淹没。最后，这个项目的成果是可视、可玩、可分享的，这种即时反馈和成就感是学习编程最强的驱动力之一。接下来，我会带你从环境搭建开始，一步步拆解每个核心模块的实现，并分享我在开发过程中踩过的坑和总结的技巧，让你不仅能复现这个游戏，更能理解其背后的设计思想。

2. 开发环境搭建与Pygame初探

2.1 Python与Pygame安装要点

工欲善其事，必先利其器。我们的开发环境非常简单：Python 3.8或以上版本，以及Pygame库。我强烈建议使用Python 3.8+，因为它与目前绝大多数库的兼容性最好，同时也是许多教程默认的版本。

Python安装：如果你还没有安装Python，请前往Python官网下载安装包。安装时务必勾选“Add Python to PATH”这个选项，这能让你在命令行中直接使用python和pip命令，避免后续很多麻烦。安装完成后，打开命令行（Windows上是CMD或PowerShell，macOS/Linux上是Terminal），输入python --version，如果能看到版本号（如Python 3.10.0），说明安装成功。

Pygame安装：Pygame的安装通过pip工具一键完成。在命令行中输入以下命令：

pip install pygame

如果下载速度慢，可以使用国内的镜像源加速，例如清华源：

pip install pygame -i https://pypi.tuna.tsinghua.edu.cn/simple

安装完成后，可以写一个简单的测试脚本来验证。创建一个名为test_pygame.py的文件，输入以下代码：

import pygame pygame.init() print(“Pygame初始化成功！”) screen = pygame.display.set_mode((800, 600)) pygame.display.set_caption(“测试窗口”) running = True while running: for event in pygame.event.get(): if event.type == pygame.QUIT: running = False screen.fill((255, 255, 255)) # 用白色填充屏幕 pygame.display.flip() # 更新屏幕显示 pygame.quit()

运行这个脚本，如果弹出一个白色的800x600像素的窗口，并且关闭窗口后程序正常退出，同时在命令行打印出成功信息，那么恭喜你，环境配置完全正确。

注意：有些初学者在安装多个Python版本时容易混淆pip。如果你安装了Anaconda，要确保你是在目标Python环境（虚拟环境）下使用pip。一个简单的检查方法是，在命令行先输入python进入交互模式，查看显示的版本，退出后再用pip install。或者直接使用python -m pip install pygame命令，这样可以精确指定使用当前python解释器对应的pip。

2.2 代码编辑器与项目管理

对于这个项目，任何文本编辑器都可以，但我推荐使用专为编程设计的编辑器或IDE，它们能提供语法高亮、代码提示和调试功能，极大提升效率。Visual Studio Code (VSCode)是一个绝佳的选择，它轻量、免费且插件生态丰富。

在VSCode中，你需要安装Python扩展（由Microsoft发布）。安装后，它就能识别.py文件，提供智能提示、代码格式化、调试等功能。你可以创建一个单独的文件夹（例如ninja_cat_game）来存放项目所有文件，这样管理起来更清晰。在项目根目录下，你通常会有以下几个文件：主程序文件（如main.py）、存放图片和声音的assets文件夹、以及可能存在的配置文件。良好的项目结构从一开始就养成了好习惯。

3. 游戏核心架构设计与思路拆解

在动手写代码之前，我们先在脑子里把游戏的框架搭起来。一个基于Pygame的游戏，其核心是一个“游戏循环”（Game Loop）。这个循环每秒钟会运行几十次（由帧率FPS控制），在每一次循环中，我们按顺序做以下几件事：

处理事件：检查玩家输入（如按键、鼠标点击）、系统事件（如退出）。
更新游戏状态：根据输入和游戏逻辑，更新所有游戏对象的位置、状态（例如，忍者猫是否跳跃、障碍物是否向左移动、分数是否增加）。
渲染（绘制）：将更新后的所有游戏对象绘制到屏幕上。
控制帧率：确保循环以稳定的速度运行，避免游戏速度受电脑性能影响过大。

基于这个循环，我们可以将游戏对象抽象为几个类，这是面向对象编程思想在游戏开发中的典型应用：

游戏主控类 (Game): 负责管理游戏循环、状态（开始、进行中、结束）、分数、以及协调其他所有对象。
精灵类 (Sprite): Pygame提供了一个pygame.sprite.Sprite基类，我们的忍者猫、障碍物、硬币都可以继承自它。精灵类封装了图像（Surface）、位置（Rect）以及更新和绘制自身的方法。
忍者猫类 (NinjaCat): 玩家控制的角色。需要处理跳跃的物理逻辑（重力、速度）、动画帧切换、以及碰撞箱的更新。
障碍物类 (Obstacle): 包括地面障碍（如箱子、树桩）和空中障碍（如飞鸟、蝙蝠）。它们以恒定或变化的速度从屏幕右侧向左侧移动，制造挑战。
硬币类 (Coin): 可收集物品，同样从右向左移动，与忍者猫碰撞后消失并为玩家加分。

这种架构的好处是职责清晰，每个类只关心自己的数据和行为。当游戏逻辑变得复杂时（比如增加多种敌人、特效），你只需要新增或修改对应的类，而不会让主循环代码变得一团糟。这是构建可维护、可扩展游戏代码的基础。

4. 核心模块实现与代码精讲

4.1 游戏初始化与主循环搭建

让我们从创建游戏窗口和主循环开始。在main.py中，我们首先导入必要的模块，并进行初始化。

import pygame import sys import random from settings import * # 我们将游戏常量放在单独的settings.py文件中 from sprites import NinjaCat, Obstacle, Coin # 从自定义的精灵模块导入类 class Game: def __init__(self): pygame.init() # 创建游戏窗口，尺寸定义在settings.py中 self.screen = pygame.display.set_mode((SCREEN_WIDTH, SCREEN_HEIGHT)) pygame.display.set_caption(“忍者猫大冒险”) self.clock = pygame.time.Clock() # 用于控制帧率的时钟对象 self.running = True self.game_active = False # 游戏状态：开始界面、游戏中、结束界面 self.score = 0 self.font = pygame.font.Font(None, 36) # 创建一个字体对象用于显示分数 # 创建精灵组。Pygame的精灵组能高效地管理和绘制大量精灵。 self.all_sprites = pygame.sprite.Group() # 所有需要更新的精灵 self.obstacles = pygame.sprite.Group() # 专门存放障碍物，用于碰撞检测 self.coins = pygame.sprite.Group() # 专门存放硬币 # 创建玩家角色，并加入到all_sprites组 self.player = NinjaCat() self.all_sprites.add(self.player) # 加载背景图像（如果有） self.bg_image = pygame.image.load(“assets/background.png”).convert() self.bg_rect = self.bg_image.get_rect() def run(self): """游戏主循环""" while self.running: self.dt = self.clock.tick(FPS) / 1000.0 # 计算上一帧到这一帧的时间差（秒），用于实现与帧率无关的运动 self.events() self.update() self.draw() pygame.quit() sys.exit()

在上面的代码中，有几个关键点：

pygame.display.set_mode()创建了游戏窗口，返回一个Surface对象，我们之后的所有绘制都发生在这个Surface上。
self.clock.tick(FPS)是控制帧率的核心。FPS（如60）定义了每秒最大帧数。tick()方法会计算自上次调用后经过的时间，并暂停足够长的时间以确保循环频率不超过FPS。它返回的是以毫秒为单位的时间，我们除以1000转换为秒，存入self.dt。这是实现平滑运动的关键。如果不使用dt，物体运动速度会随着电脑帧率变化而变化，在高性能电脑上游戏会快得飞起。
我们将游戏常量（如SCREEN_WIDTH,SCREEN_HEIGHT,FPS, 重力加速度GRAVITY，玩家跳跃速度JUMP_FORCE等）集中放在settings.py文件中，这样修改参数非常方便，代码也更清晰。

4.2 忍者猫角色：跳跃、动画与状态管理

忍者猫是我们游戏的主角，它的实现是整个游戏逻辑的核心之一。我们需要让它能响应空格键或上箭头键跳跃，并且在跳跃过程中受到重力影响，落地后能再次起跳。同时，我们可能希望它有不同的动画状态（跑动、跳跃、下蹲）。

# 在 sprites.py 文件中 class NinjaCat(pygame.sprite.Sprite): def __init__(self): super().__init__() # 加载角色图像序列，制作动画 self.run_frames = [pygame.image.load(f“assets/cat_run_{i}.png”).convert_alpha() for i in range(1, 5)] self.jump_frame = pygame.image.load(“assets/cat_jump.png”).convert_alpha() self.duck_frames = [pygame.image.load(f“assets/cat_duck_{i}.png”).convert_alpha() for i in range(1, 3)] self.current_frame = 0 self.animation_speed = 0.15 # 控制动画播放速度 self.image = self.run_frames[0] # 初始图像 self.rect = self.image.get_rect(midbottom=(100, GROUND_LEVEL)) # 初始位置在地面 # 物理属性 self.velocity_y = 0 # Y轴速度，向上为负，向下为正 self.gravity = GRAVITY # 从settings导入 self.jump_power = JUMP_POWER self.is_jumping = False self.is_ducking = False def update(self, dt): """更新角色状态，dt是时间增量（秒）""" # 处理键盘输入 keys = pygame.key.get_pressed() if keys[pygame.K_SPACE] or keys[pygame.K_UP]: self.jump() if keys[pygame.K_DOWN]: self.duck() else: self.is_ducking = False # 应用重力 self.velocity_y += self.gravity * dt self.rect.y += self.velocity_y * dt * 60 # 乘以60是为了将速度单位转换为“像素/秒”，便于理解 # 确保角色不会掉出地面 if self.rect.bottom >= GROUND_LEVEL: self.rect.bottom = GROUND_LEVEL self.velocity_y = 0 self.is_jumping = False # 更新动画 self.animate(dt) def jump(self): if not self.is_jumping and not self.is_ducking: # 只有在地面且未下蹲时才能跳 self.velocity_y = -self.jump_power self.is_jumping = True def duck(self): if not self.is_jumping: # 跳跃时不能下蹲 self.is_ducking = True # 下蹲时，碰撞箱rect的高度和位置需要调整，以通过低矮障碍 # 这里简化处理，实际可能需要切换图像和rect def animate(self, dt): """根据状态播放不同动画""" self.animation_timer += dt if self.is_jumping: self.image = self.jump_frame elif self.is_ducking: # 播放下蹲动画序列 if self.animation_timer >= self.animation_speed: self.current_frame = (self.current_frame + 1) % len(self.duck_frames) self.image = self.duck_frames[self.current_frame] self.animation_timer = 0 else: # 播放奔跑动画序列 if self.animation_timer >= self.animation_speed: self.current_frame = (self.current_frame + 1) % len(self.run_frames) self.image = self.run_frames[self.current_frame] self.animation_timer = 0

关键点解析与避坑指南：

图像加载与透明通道：使用convert_alpha()方法加载PNG图像可以保留Alpha通道（透明度），这对于不规则形状的角色和物体至关重要，否则它们会被一个白色的矩形背景包围。
时间增量dt的应用：注意在update方法中，速度和位置的更新都乘以了dt。这是帧率独立运动的标准做法。velocity_y * dt表示这一帧时间内垂直方向的位移。如果不乘dt，移动速度将与帧率绑定，游戏体验会不一致。
碰撞箱（Rect）管理：self.rect是Pygame用于碰撞检测和定位的矩形区域。当角色下蹲或切换动画帧时，图像的尺寸可能改变，必须同步更新rect的尺寸和位置，否则碰撞检测会错位。一个常见的做法是记录角色“脚部”的世界坐标，切换图像后，根据新图像的get_rect()和脚部坐标重新设置rect。
状态标志：is_jumping和is_ducking这些布尔标志是管理角色状态机的简单有效方式。它们决定了哪些输入有效、播放什么动画。

4.3 障碍物与硬币的生成与管理

障碍物和硬币是游戏中的“NPC”，它们从屏幕右侧生成，以恒定速度向左移动，移出屏幕左侧后被销毁。为了增加游戏性，它们的生成应该是随机的。

class Obstacle(pygame.sprite.Sprite): def __init__(self, obstacle_type): super().__init__() self.type = obstacle_type # 例如：’crate‘, ’bird‘ if self.type == ‘crate’: self.image = pygame.image.load(“assets/crate.png”).convert_alpha() self.rect = self.image.get_rect(bottomleft=(SCREEN_WIDTH, GROUND_LEVEL)) elif self.type == ‘bird’: self.image = pygame.image.load(“assets/bird.png”).convert_alpha() # 鸟在空中飞行，位置随机 self.rect = self.image.get_rect(midleft=(SCREEN_WIDTH, random.randint(100, 300))) self.speed = OBSTACLE_SPEED def update(self, dt): self.rect.x -= self.speed * dt * 60 # 向左移动 if self.rect.right < 0: # 完全移出屏幕左侧 self.kill() # 从所有包含它的精灵组中移除，释放内存 class Coin(pygame.sprite.Sprite): def __init__(self): super().__init__() self.image = pygame.image.load(“assets/coin.png”).convert_alpha() self.rect = self.image.get_rect(midleft=(SCREEN_WIDTH, random.randint(50, 400))) self.speed = COIN_SPEED self.spin_angle = 0 def update(self, dt): self.rect.x -= self.speed * dt * 60 if self.rect.right < 0: self.kill() # 添加旋转动画 self.spin_angle += 300 * dt # 每秒旋转300度 original_image = self.image self.image = pygame.transform.rotate(original_image, self.spin_angle) # 旋转后rect会变，需要重新定位中心点，否则会乱飞 self.rect = self.image.get_rect(center=self.rect.center)

在游戏主类Game中，我们需要一个方法来定时生成这些物体。我们可以利用Pygame的时间事件（pygame.USEREVENT）或者基于游戏运行时间（pygame.time.get_ticks()）来判断。

# 在 Game 类的 __init__ 中添加 self.obstacle_timer = 0 self.coin_timer = 0 self.obstacle_frequency = 1500 # 毫秒，每1.5秒尝试生成一个障碍 self.coin_frequency = 1000 # 毫秒，每1秒尝试生成一个硬币 # 在 Game 类的 update 方法中添加 def update(self): current_time = pygame.time.get_ticks() # 生成障碍物 if current_time - self.obstacle_timer > self.obstacle_frequency: self.obstacle_timer = current_time if random.random() < 0.7: # 70%的概率生成障碍 obstacle_type = random.choice([‘crate’, ‘bird’]) new_obstacle = Obstacle(obstacle_type) # 生成前检查，避免与现有障碍物重叠（简单检查） if not pygame.sprite.spritecollide(new_obstacle, self.obstacles, False): self.all_sprites.add(new_obstacle) self.obstacles.add(new_obstacle) # 生成硬币（类似逻辑） if current_time - self.coin_timer > self.coin_frequency: self.coin_timer = current_time if random.random() < 0.5: # 50%的概率生成硬币 new_coin = Coin() # 检查硬币是否与障碍物位置冲突（可选，增加可收集性） if not pygame.sprite.spritecollide(new_coin, self.obstacles, False, pygame.sprite.collide_circle_ratio(0.7)): self.all_sprites.add(new_coin) self.coins.add(new_coin)

实操心得：物体生成逻辑是游戏节奏控制的关键。obstacle_frequency和生成概率共同决定了游戏的难度曲线。一个常见的技巧是让这些参数随着游戏分数（或时间）的增加而动态变化，例如分数越高，障碍物生成频率越快，或者出现更难躲避的组合障碍，从而实现游戏难度的渐进提升。

4.4 碰撞检测与游戏逻辑响应

碰撞检测是游戏交互的核心。Pygame的spritecollide和spritecollideany函数非常好用。我们需要检测两种碰撞：忍者猫与障碍物（游戏结束）、忍者猫与硬币（得分）。

# 在 Game 类的 update 方法中，在更新所有精灵位置后 def update(self): # ... 更新所有精灵的代码 ... self.all_sprites.update(self.dt) # 碰撞检测：玩家 vs 障碍物 if pygame.sprite.spritecollide(self.player, self.obstacles, False, pygame.sprite.collide_mask): # 使用 collide_mask 进行像素级精确碰撞检测，而不是矩形检测 self.game_active = False # 游戏结束 # 可以在这里播放碰撞音效、触发死亡动画等 # 碰撞检测：玩家 vs 硬币 coins_collected = pygame.sprite.spritecollide(self.player, self.coins, True, pygame.sprite.collide_circle) # True 表示碰撞后硬币会被销毁(kill) for coin in coins_collected: self.score += 10 # 每个硬币加10分 # 可以在这里播放收集音效、显示得分动画等

碰撞检测类型选择：

pygame.sprite.collide_rect：默认的矩形碰撞检测，速度快但不精确，适合形状接近矩形的物体（如箱子）。
pygame.sprite.collide_circle：圆形碰撞检测，需要精灵有radius属性。比矩形精确，性能也不错，适合形状接近圆形的物体（如硬币）。collide_circle_ratio(0.7)可以按比例缩放碰撞圆。
pygame.sprite.collide_mask：像素级完美碰撞检测。它比较两个精灵图像非透明像素的重叠部分。这是最精确的检测方式，但计算开销也最大。使用时，需要确保精灵的图像有正确的透明通道，并且精灵类在__init__中设置了self.mask = pygame.mask.from_surface(self.image)。对于“忍者猫”这种不规则形状的角色，与障碍物碰撞时强烈推荐使用collide_mask，否则玩家会感觉判定不公平。

4.5 分数显示、游戏状态与界面绘制

最后，我们需要将游戏状态反馈给玩家。这包括在屏幕上绘制分数、游戏开始/结束的提示文字等。

# 在 Game 类的 draw 方法中 def draw(self): # 1. 绘制背景 self.screen.blit(self.bg_image, self.bg_rect) # 如果需要滚动背景，可以绘制多个背景图并移动它们的位置 # 2. 绘制所有精灵 self.all_sprites.draw(self.screen) # 3. 绘制UI（分数、提示等） score_surface = self.font.render(f‘Score: {self.score}’, True, (255, 255, 255)) self.screen.blit(score_surface, (10, 10)) if not self.game_active: # 游戏未开始或已结束，显示提示信息 if self.score == 0: text = “Press SPACE to Start!” else: text = f“Game Over! Final Score: {self.score}. Press SPACE to Restart.” prompt_surface = self.font.render(text, True, (255, 50, 50)) text_rect = prompt_surface.get_rect(center=(SCREEN_WIDTH//2, SCREEN_HEIGHT//2)) self.screen.blit(prompt_surface, text_rect) # 4. 更新整个屏幕显示 pygame.display.flip()

事件处理：我们还需要在events()方法中处理游戏状态的切换。

def events(self): for event in pygame.event.get(): if event.type == pygame.QUIT: self.running = False if event.type == pygame.KEYDOWN: if event.key == pygame.K_SPACE: if not self.game_active: # 重置游戏状态，开始新游戏 self.game_active = True self.score = 0 # 清空所有障碍物和硬币 for sprite in self.obstacles: sprite.kill() for sprite in self.coins: sprite.kill() # 重置玩家位置和状态 self.player.rect.midbottom = (100, GROUND_LEVEL) self.player.velocity_y = 0 self.player.is_jumping = False

至此，一个具备核心玩法的“忍者猫”游戏就搭建完成了。运行main.py，你应该能看到一个窗口，按空格键开始游戏，控制忍者猫跳跃躲避障碍、收集硬币，并在碰撞后游戏结束。

5. 性能优化、音效与高级特性拓展

一个基础版本的游戏已经完成，但要让游戏体验更上一层楼，我们还需要考虑一些优化和增强功能。

5.1 图像与性能优化

图像缩放与转换：如果你的原始素材尺寸很大，在游戏初始化时一次性缩放到合适尺寸，比在每一帧都进行缩放要高效得多。使用pygame.transform.scale()。
双缓冲与脏矩形更新：Pygame默认使用双缓冲，pygame.display.flip()会交换前后缓冲区。对于静态背景较多的游戏，可以考虑“脏矩形”更新，即只更新屏幕上发生变化的部分，而不是每帧重绘整个屏幕。但对于我们这个动态元素较多的跑酷游戏，全屏更新（flip()）通常更简单直接，在60FPS下性能也足够。
精灵组绘制优化：self.all_sprites.draw(self.screen)内部已经做了优化。确保不在游戏循环中频繁创建和销毁大量Surface对象（如图像、文本），而应预先创建好。

5.2 添加音效与背景音乐

声音是游戏体验不可或缺的一环。Pygame的pygame.mixer模块可以轻松处理音效。

# 在 Game 类的 __init__ 中加载音效 try: self.jump_sound = pygame.mixer.Sound(“assets/jump.wav”) self.coin_sound = pygame.mixer.Sound(“assets/coin.wav”) self.crash_sound = pygame.mixer.Sound(“assets/crash.wav”) # 设置音量 self.jump_sound.set_volume(0.5) except pygame.error as e: print(f“Could not load sound: {e}”) # 处理音效加载失败的情况，避免游戏崩溃 # 在 NinjaCat 的 jump 方法中播放音效 def jump(self): if not self.is_jumping and not self.is_ducking: self.velocity_y = -self.jump_power self.is_jumping = True if hasattr(game, ‘jump_sound’): # 确保游戏对象已加载音效 game.jump_sound.play()

背景音乐可以使用pygame.mixer.music模块循环播放。

pygame.mixer.music.load(“assets/bg_music.mp3”) pygame.mixer.music.set_volume(0.3) pygame.mixer.music.play(-1) # -1 表示无限循环

5.3 实现视差滚动背景

静态背景略显单调。视差滚动背景能极大地增强游戏的视觉深度和速度感。原理是让不同图层（远景、中景、近景）以不同的速度移动。

class ParallaxBackground: def __init__(self, image_path, speed_factor): self.image = pygame.image.load(image_path).convert_alpha() self.rect = self.image.get_rect() self.speed_factor = speed_factor # 速度因子，1.0表示与地面同速，小于1则更慢（远景） self.x1 = 0 self.x2 = self.rect.width # 第二张图紧接第一张图右侧 def update(self, dt, world_speed): # world_speed 是游戏世界向左移动的基础速度 move_amount = world_speed * self.speed_factor * dt * 60 self.x1 -= move_amount self.x2 -= move_amount # 如果一张图完全移出屏幕左侧，就把它放到右侧队列的末尾 if self.x1 <= -self.rect.width: self.x1 = self.x2 + self.rect.width if self.x2 <= -self.rect.width: self.x2 = self.x1 + self.rect.width def draw(self, screen): screen.blit(self.image, (self.x1, 0)) screen.blit(self.image, (self.x2, 0)) # 在 Game 类中创建多个背景层 self.bg_layers = [ ParallaxBackground(“assets/bg_sky.png”, 0.2), # 远景，移动最慢 ParallaxBackground(“assets/bg_mountains.png”, 0.5), # 中景 ParallaxBackground(“assets/bg_trees.png”, 0.8), # 近景 ] # 在 update 和 draw 方法中分别更新和绘制这些层

6. 项目打包与分发

当你完成了游戏开发，并希望分享给没有安装Python的朋友时，就需要将项目打包成独立的可执行文件（.exe for Windows, .app for macOS等）。PyInstaller是目前最流行的工具。

首先安装PyInstaller：

pip install pyinstaller

然后，在项目根目录下打开命令行，执行打包命令。一个基本的命令如下：

pyinstaller --onefile --windowed --add-data “assets;assets” main.py

--onefile: 将所有依赖打包成一个单独的exe文件。
--windowed: 运行时不显示命令行控制台窗口（对于图形游戏必备）。
--add-data “assets;assets”: 将assets文件夹（包含图片、声音）添加到打包文件中。分号;前是源文件夹，后是打包后在exe内的虚拟路径（Windows用分号，macOS/Linux用冒号:）。

打包过程可能会遇到一些问题，比如找不到动态链接库（DLL）。一个非常实用的技巧是，在打包前，先在一个干净的虚拟环境中安装项目依赖（pip install pygame），然后在这个虚拟环境中运行PyInstaller，可以避免很多因环境混乱导致的问题。打包生成的可执行文件会在dist文件夹中。记得将assets文件夹复制到与exe文件相同的目录下，除非你在命令中正确指定了资源路径。

7. 开发中常见问题与调试技巧实录

即使按照教程一步步来，你也可能会遇到各种“坑”。这里记录了几个最常见的问题和我的解决方法。

问题1：游戏窗口一闪而过，或者打开后立即关闭。

原因：最可能的原因是程序中有未捕获的异常导致崩溃。Pygame初始化失败、图片路径错误、音效文件格式不支持等都可能导致。
排查：不要直接运行python main.py，而是在命令行中运行，这样崩溃时错误信息会打印在终端里。仔细阅读错误提示，它能精准定位问题所在。例如，FileNotFoundError意味着资源文件路径不对；pygame.error: Couldn‘t open ...可能是图片格式问题。

问题2：角色或物体移动时“卡顿”或“抖动”。

原因：这通常与帧率不稳定或运动计算未考虑时间增量（dt）有关。
解决：
1. 确保在主循环中使用了self.clock.tick(FPS)来控制帧率，并且FPS值设置合理（如60）。
2. 务必在所有运动更新代码中乘以时间增量dt。这是解决抖动问题的关键。position += velocity * dt。
3. 检查物体的移动速度值是否过大，过大的速度即使乘以dt也可能导致每帧位移超过一个像素，在低帧率下产生跳跃感。

问题3：碰撞检测不准确，明明没碰到却死了，或者穿模了。

原因：
- 使用了不合适的碰撞检测方法（如对不规则精灵用矩形检测）。
- 精灵的图像（self.image）更新后，其碰撞区域（self.rect）没有同步更新。
- 运动速度太快，一帧就穿过了障碍物（“子弹穿过纸张”问题）。
解决：
1. 为不规则精灵使用collide_mask检测，并确保设置了self.mask。
2. 在精灵的update方法中，如果改变了图像（如切换动画帧），记得用新图像的get_rect()结合旧rect的某个锚点（如midbottom）来重新定位rect。
3. 对于高速移动的物体，可以考虑使用“连续碰撞检测”（CCD），或者增加碰撞检测的频率（例如，将物体的移动分解为多小步进行检测）。在我们的游戏中，障碍物移动速度相对较慢，通常不需要CCD。

问题4：游戏运行一段时间后越来越卡。

原因：内存泄漏。最常见的原因是不断创建新的精灵（如障碍物、硬币），但移出屏幕后没有正确销毁（kill()）。
解决：确保所有移出屏幕或不再需要的精灵都调用了kill()方法。Pygame的kill()方法会将该精灵从其所属的所有精灵组中移除，Python的垃圾回收机制随后会清理它。在上面的Obstacle和Coin类的update方法中，我们检查if self.rect.right < 0:然后调用self.kill()，正是为了这个目的。

问题5：打包后的exe文件找不到图片或音效。

原因：PyInstaller打包时，代码中的相对路径（如“assets/image.png”）在exe运行环境下可能失效。exe运行时有一个临时解压目录，资源文件在那里。
解决：使用以下方法来获取资源文件的正确绝对路径：

import sys import os def resource_path(relative_path): """获取资源的绝对路径。在开发环境和PyInstaller打包后都能工作""" try: # PyInstaller创建的临时文件夹路径 base_path = sys._MEIPASS except Exception: # 正常开发环境下的路径 base_path = os.path.abspath(“.”) return os.path.join(base_path, relative_path) # 加载资源时 image = pygame.image.load(resource_path(“assets/image.png”))

并且在PyInstaller命令中确保正确添加了资源文件夹：--add-data “assets;assets”。

开发游戏是一个不断迭代和调试的过程。遇到问题时，善用print()语句输出关键变量（如位置、速度、碰撞状态），或者使用Pygame的pygame.draw.rect(screen, (255,0,0), sprite.rect, 2)在屏幕上绘制出碰撞框，都是非常有效的调试手段。当你看到红色的框线时，就能直观地理解碰撞检测到底是如何工作的了。

查看全文

http://www.jsqmd.com/news/1286214/