第一次用Python写出一个能动能打、还能记分的游戏那种成就感和跑通一个爬虫脚本完全不是一回事。飞机大战这个题目在入门圈子里被翻来覆去地讲但绝大多数教程只给你一堆能跑的代码不告诉你为什么这么写、改一行会崩在哪里、为什么自己的版本一开就黑屏。我前后用pygame重写过三个版本的飞机大战从最早那个满屏bug的版本到后来能打包发给朋友玩的成品中间踩的坑足够写一篇长文。这篇内容就是把这些年攒下来的经验一次讲清楚一个完整的Python飞机大战需要哪些模块、每个模块背后的设计理由是什么、素材和音效怎么处理、打包时分发会遇到什么问题。它适合刚学完Python基础语法、想找个项目把知识串起来的人也适合写过一点小游戏但总觉得代码一团乱的人。看完你应该能独立写出一个结构清晰、能跑能改、还能发给别人玩的版本而不是只会复制粘贴三十行源码。1. 为什么飞机大战值得用Python从头写一遍1.1 它把游戏开发该有的要素全占了很多人选练手项目的时候会纠结贪吃蛇太简单俄罗斯方块逻辑又绕。飞机大战刚好卡在中间——它的机制不多但每一个都触及了游戏开发的核心问题。你至少得处理这几件事实时输入键盘按住不放要连续移动、对象生命周期子弹飞出去要销毁敌机被击中要消失、碰撞判定矩形重叠检测、状态管理开始界面、游戏中、结算界面切换、时间控制帧率锁定否则游戏在不同电脑上快慢不一。这五个问题在你的第二个、第三个项目里还会反复出现提前在这个题目上把它们想明白后面写任何小游戏都是换皮。再说得直白一点飞机大战最大的价值不是能做出来而是做出来之后你能看出自己代码的毛病。我第一版把玩家、敌机、子弹的逻辑全部塞在主循环里两百多行代码改一个敌机速度要翻三个地方加一个 Boss 就得重写。第二版改成面向对象之后敌机子类继承一下就能多出三种行为。这个过程本身就是最有价值的收获。1.2 别急着抄源码先说清楚抄的正确姿势网上流传的飞机大战源码多到离谱随手一搜就是几十份标题还都写着完整可运行。我的建议是第一份代码一定自己写哪怕写得丑第二份开始再去看别人的实现重点看类的划分方式和主循环的写法。原因很简单——飞机大战真正的难点不在语法而在把一堆需求翻译成代码结构的能力。你抄来的代码大概率能跑但当你想把敌机从直线下落改成左右摆动时如果连自己都不清楚速度向量存在哪个变量里改起来就是灾难。我见过太多人拿着现成源码改了半天最后改成了一堆互相打架的补丁连自己都读不懂。所以这篇内容不会给你一份可以无脑粘贴的完整代码而是按为什么这样设计的顺序把每一层拆开讲。你可以边看边写写完一段跑一段这样出问题的时候你能立刻定位到是哪一段引入的。2. 图形库怎么选pygame、arcade与tkinter的取舍逻辑2.1 三套方案的横向对比Python做2D游戏能用的库其实就那几个。我在不同项目里都用过先把差别摆出来你再决定要不要跟着走。方案上手难度性能表现生态与资料适合场景pygame低中等60帧小游戏足够极其丰富中文资料多2D小游戏、教学、原型arcade中较好基于OpenGL资料偏少更新活跃度一般需要更多绘制特效的项目tkinter Canvas低差大量对象会卡内置无需安装只画静态图或极简交互pyglet中高好文档英文为主想深入底层的人结论很明确练手项目选pygame。它的接口设计直白Surface、Rect、Sprite这几个概念一遍就能懂遇到问题搜中文也有一大堆答案。arcade虽然API更现代但当你卡在某个奇怪报错上时能搜到的中文结果可能只有个位数对新手很不友好。tkinter的问题是性能——它原本是给表单和按钮设计的你往上贴几百个图像对象帧率会直接掉下来。2.2 帧与事件循环游戏脚本和普通脚本的分水岭这是我觉得最该先讲清楚的一点。你之前写的Python脚本大概是这样的从头到尾执行一遍结束。游戏不是。游戏是一个无限循环每一轮循环叫做一帧。一帧里要做的事固定就那么几步先把这一帧发生的所有事件读出来按键、鼠标、关闭窗口然后根据输入更新所有对象的位置和状态接着把整个画面重新画一遍最后等一小会儿让帧率保持稳定。这个顺序不能乱。如果你先更新再读事件那这一帧的按键要等到下一帧才生效操作会有一帧延迟快速移动时会明显感觉跟不上手。如果你先画图再更新位置那画面永远显示的是上一帧的状态同样是延迟。pygame里正确的骨架长这样import pygame import sys pygame.init() screen pygame.display.set_mode((480, 700)) clock pygame.time.Clock() running True while running: # 1. 处理事件 for event in pygame.event.get(): if event.type pygame.QUIT: running False # 2. 更新对象状态 # 3. 绘制画面 # 4. 刷新显示并控制帧率 pygame.display.flip() clock.tick(60) pygame.quit() sys.exit()pygame.display.flip()和clock.tick(60)这两行是新手最容易漏的。前者负责把你在内存里画好的画面真正推到屏幕上漏了就是一片黑后者负责把循环速度压在每秒60次漏了你的飞机就会快到看不见——因为循环会以CPU的最大速度疯狂执行。我第一次写的时候就是把这两行忘了结果窗口黑屏闪一下就卡死排查了半个小时。2.3 环境准备虚拟环境、pip源与版本坑安装本身不复杂pip install pygame一句话的事。但有几个细节值得提前处理能省掉后面很多麻烦。第一用虚拟环境。别把游戏依赖装进系统Python里。项目做多了之后依赖互相冲突是很常见的事虚拟环境能让你每个项目互不干扰。创建和激活的命令# 创建虚拟环境 python -m venv venv # Windows 激活 venv\Scripts\activate # macOS / Linux 激活 source venv/bin/activate # 安装依赖 pip install pygame第二注意Python版本和pygame版本的匹配。老版本的pygame在Python 3.11以上偶尔会有编译问题建议用较新的pygame 2.x。如果你装的时候看到一堆红色报错、提示找不到某个头文件八成是在尝试从源码编译直接指定版本pip install pygame2.1通常能拿到预编译的轮子包。第三编辑器配置。VS Code Python插件就够了重点是让它识别到你激活的那个虚拟环境。如果写代码时import pygame一直标黄线但运行没问题那就是解释器选错了按CtrlShiftP搜Python: Select Interpreter切一下即可。至于用PyCharm的人在项目设置里把解释器指到venv目录下就行。3. 用对象建模天空玩家机、敌机、子弹该有哪些属性3.1 面向对象拆解的四个角色飞机大战里其实就四个角色玩家机、敌机、子弹、爆炸特效。它们的共同点是都有自己的位置、自己的外观、每帧都要动。差别在于动的规则不同、被谁控制不同。如果不用类你会得到一堆平行的列表enemy_x []、enemy_y []、enemy_speed []然后每次删敌机都要同步删三个列表一旦漏删一个就错位敌机图像和位置对不上看起来像鬼片。这是我第一版代码的真实惨状。用类之后就清爽了每个对象自己管自己的数据列表里只存对象本身。删的时候enemy_list.remove(enemy)一行搞定不会有残留。我建议的类划分是这样的Player只处理键盘输入、位置更新、发射冷却计时Enemy处理下落、随机横向漂移、血量如果要做Bullet只负责匀速上升和越界自毁Explosion只负责播放动画帧序列放完自己删掉分成四个类会不会太碎不会。判断标准是如果两段逻辑的修改原因不同就该分开。敌机的速度和子弹的速度完全是两回事改一个不影响另一个那就该是两个类。3.2 精灵与精灵组pygame.sprite带来的三个便利pygame提供了一套Sprite和Group机制很多人第一次看觉得多余——我自己维护列表不行吗行但用精灵组能白拿三样东西。第一是批量更新和批量绘制。sprite_group.update()会调用组里每个精灵的update()方法sprite_group.draw(screen)会按顺序把每个精灵画到屏幕上。你自己写循环也行但精灵组内部做了不少优化而且省掉一堆样板代码。第二是碰撞检测的现成实现。pygame.sprite.spritecollide(player, enemy_group, False)这一行就能查出玩家和哪些敌机撞了。它内部用的是矩形碰撞但已经帮你处理好了遍历和返回结果比手写双重循环舒服得多。第三是分组管理。你可以把子弹放进bullet_group敌机放进enemy_group然后pygame.sprite.groupcollide(bullet_group, enemy_group, True, True)一行同时完成子弹打中敌机、子弹和敌机都消失这件事。这种表达方式比手动遍历两个列表清晰太多出bug的概率也低。用精灵的标准写法是继承pygame.sprite.Sprite然后至少做三件事调用父类构造函数、设置self.image、设置self.rect。import pygame import random class Enemy(pygame.sprite.Sprite): def __init__(self, image, speed): super().__init__() self.image image self.rect self.image.get_rect() self.rect.x random.randint(0, 480 - self.rect.width) self.rect.y -self.rect.height self.speed speed def update(self, *args): self.rect.y self.speed # 飞出屏幕底部就销毁自己 if self.rect.top 700: self.kill()self.kill()这个方法值得单独说一句——它会把这个精灵从所有它所属的组里移除。这是精灵组机制里最贴心的一处设计意味着你不需要在遍历的时候小心翼翼地删元素只要对象自己判断我该消失了然后调用kill()剩下的交给组去处理。这一点在第7节讲崩溃排查时还会再展开。3.3 坐标系、速度向量与帧率的关系pygame的坐标系有点反直觉原点在窗口左上角x向右增加y向下增加。所以向下落是y speed向上飞是y - speed。刚接触的时候我总想写y - speed表示下落结果敌机全飞天上去了。更关键的是速度值的单位问题。self.rect.y 5这句话的意思是每一帧移动5像素。而帧率是60所以实际速度是每秒300像素。这意味着如果你改了帧率所有物体的速度都会跟着变。假设你一开始用clock.tick(30)敌机设成每帧5像素实际是150像素/秒。后来你觉得画面不够流畅改成60帧忘了改速度敌机立刻变成300像素/秒游戏难度直接翻倍。这就是为什么大型项目里会用delta time两帧之间的时间差来计算位移让速度脱离帧率独立存在。小游戏要不要上delta time我的看法是如果你打算锁定60帧不折腾可以先用固定像素值简单直观但只要你有跨设备分发的打算尽早改成delta time。改法不难把速度定义成每秒多少像素然后乘上clock.tick(60) / 1000.0返回的毫秒数dt clock.tick(60) / 1000.0 # 转成秒 self.rect.y self.speed * dt这样无论帧率怎么变物体每秒移动的距离始终一致。代价是你得把速度值从5改成300这种量级一开始会觉得别扭习惯就好。4. 主循环骨架落地从黑窗口到一架能动的飞机4.1 事件处理的正确姿势事件处理有个经典陷阱用event判断连续按键是错的。pygame.event.get()返回的是这一帧内发生的事情比如某个键被按下了这个动作发生了一次。但玩家按住方向键不放的时候这个动作只会触发一次忽略系统生成的重复事件第二帧就没有了。如果你写成# 错误示范 for event in pygame.event.get(): if event.type pygame.KEYDOWN: if event.key pygame.K_LEFT: player.rect.x - 5那结果就是按一下左键飞机只动5像素。想连续移动得用pygame.key.get_pressed()拿到当前所有键的按下状态在主循环里每帧都查一次keys pygame.key.get_pressed() if keys[pygame.K_LEFT]: player.rect.x - player.speed if keys[pygame.K_RIGHT]: player.rect.x player.speed if keys[pygame.K_UP]: player.rect.y - player.speed if keys[pygame.K_DOWN]: player.rect.y player.speed这个区别是新手最容易忽略的一点。记住分工event处理点按类操作发射子弹、暂停、退出key.get_pressed()处理按住类操作移动。顺带说一个细节如果要实现按住空格连续发射用event配合冷却计时器更容易控制射速用key.get_pressed()会让射速跟着帧率跑容易失控。4.2 渲染顺序与背景滚动的实现绘制是有层级的后画的盖住先画的。正确的顺序是背景图 → 敌机 → 子弹 → 玩家机 → 界面文字。如果把背景放在最后画整个屏幕就只剩背景了。无缝滚动的原理其实很朴素准备两张一样高的背景图一张在屏幕上方y 0一张紧贴在它下面y -高度。每帧两张图都向下移动当上面那张完全移出屏幕底部时把它瞬移到第二张上方然后继续。视觉上就形成了无限滚动。class Background: def __init__(self, image, screen_height): self.image image self.h screen_height self.y1 0 self.y2 -self.h def update(self, dt): self.y1 200 * dt self.y2 200 * dt if self.y1 self.h: self.y1 -self.h if self.y2 self.h: self.y2 -self.h def draw(self, screen): screen.blit(self.image, (0, self.y1)) screen.blit(self.image, (0, self.y2))这里有个容易忽略的点背景图的高度必须大于等于窗口高度否则两张图之间会露出黑色缝隙。如果你的素材是512乘512但窗口是480乘700拉伸一下就变形了正确做法是裁剪或重新找尺寸匹配的素材。4.3 用clock.tick锁帧与delta time的取舍clock.tick(60)这个函数有个容易被忽视的特性它返回上一帧到这一帧经过的毫秒数。所以这句话既是限制帧率又是获取时间差一举两得。问题在于tick限制的是最多60帧如果你的某一帧因为大量碰撞检测卡了80毫秒那这一帧拉长之后物体的位移会按delta time补回来——视觉上会表现为卡顿一下然后物体跳一大段。这是不可避免的只能通过优化碰撞检测的数量来缓解。我的经验是小游戏的碰撞检测对象控制在几十个以内完全没问题一旦超过两三百个子弹同时存在就需要考虑空间划分或者降低检测频率了。具体做法是每两帧才检测一次子弹和敌机视觉上几乎看不出来但计算量减半。另外提醒一句clock.tick()应该放在循环的最后它的作用是睡一小会儿让这一帧凑够16.6毫秒。放在开头会让第一帧的执行时间算进上一帧里导致初期的帧率不稳。5. 射击、碰撞与计分三个让游戏活起来的机制5.1 冷却时间决定射击手感子弹可不是想发就发的。如果每帧都能发射60帧就是每秒60发屏幕瞬间被糊满难度归零。冷却时间cooldown的做法很直接记一个上次发射的时间点每次想发射时算一下距离上次过了多久够长了才允许发射。class Player(pygame.sprite.Sprite): def __init__(self, image, bullet_image, all_group, bullet_group): super().__init__(all_group) self.image image self.rect self.image.get_rect() self.rect.centerx 240 self.rect.bottom 680 self.speed 300 self.bullet_image bullet_image self.bullet_group bullet_group self.last_shot 0 self.shoot_interval 180 # 单位毫秒 def shoot(self, now): if now - self.last_shot self.shoot_interval: self.last_shot now Bullet(self.bullet_image, self.rect.midtop, self.bullet_group)shoot_interval设多少合适这个数字直接决定手感。150到200毫秒大概是密集但不失控的区间也就是每秒5到6发。你可以先设在180跑起来试试觉得不够爽就往下调。注意时间单位统一——如果你用pygame.time.get_ticks()拿时间它是毫秒如果用的是delta time累加那就是秒别混着用否则会出现子弹几乎发不出来或者疯狂连发的极端情况。5.2 rect碰撞、mask碰撞与圆形近似的场景选择pygame默认的碰撞检测是矩形重叠也就是把每个物体的外接矩形拿来比较。这有个众所周知的问题飞机图像的四个角落通常是透明的但矩形检测不管这些所以会出现明明没碰到却判定撞了的憋屈情况。检测方式精度性能适用场景rect重叠低最快子弹、方块类、对精度要求低的场合mask像素级高慢随图像尺寸增长玩家与敌机的判定、Boss战圆形近似中快角色接近圆形、需要距离判定时对飞机大战来说我的做法是子弹对敌机用rect玩家对敌机用mask。子弹细长、数量多用rect够用且快玩家和敌机碰撞一局也就几次性能开销可以忽略但精度体验差距明显。mask碰撞的写法不复杂但有个成本要考虑# 使用 mask 需要事先为每个精灵生成 mask if pygame.sprite.collide_mask(player, enemy): # 撞上了collide_mask会在第一次调用时自动从self.image生成mask并缓存所以第一次调用会稍慢之后就没问题了。但如果你每帧都新建对象比如每次发射子弹都重新加载图像mask会反复生成性能就崩了。图像对象一定在初始化时加载一次反复复用这是铁律。5.3 分数、生命与难度曲线的设计分数和生命值看起来是次要功能但它们决定了游戏能不能让人玩第二遍。分数最直接的做法是击毁一架敌机加固定分。但如果所有敌机都是1分玩家很快就会失去目标感。我的做法是按敌机类型给不同分值小飞机1分中型机5分大型机20分Boss100分。这样玩家会自然地优先攻击高分目标产生策略选择。生命值的常见做法是三条命或者一条命加护盾。第一种更宽容适合新手第二种更紧张。我推荐一条命 受击后1.5秒无敌闪烁理由是这样既不会让玩家因为一次失误就重开又保留了紧张感。无敌状态的实现只需要一个计时器加上奇偶帧显示if self.invincible_until now: # 每隔80毫秒切换一次可见性做出闪烁效果 visible (now // 80) % 2 0 if visible: screen.blit(self.image, self.rect) else: screen.blit(self.image, self.rect)难度曲线我试过几种方案最好用的是随时间线性提升生成频率和下落速度。具体做法是维护一个elapsed累计时间生成敌机的间隔从0.8秒逐渐缩短到0.25秒敌机速度从150逐渐涨到400。关键是给个上限不然玩到三分钟后屏幕上敌机密密麻麻不是难是根本没法玩。spawn_interval max(0.25, 0.8 - elapsed * 0.004) enemy_speed min(400, 150 elapsed * 2)这两个公式里0.004和2这些系数不用死记凭手感调。先跑一局觉得涨得太快就把系数调小。5.4 爆炸动画与对象回收爆炸效果本质上是一组图片按顺序播放。你在初始化时把所有帧加载成一个列表然后按时间切换索引播完调用kill()销毁自己。class Explosion(pygame.sprite.Sprite): def __init__(self, frames, center, group): super().__init__(group) self.frames frames self.index 0 self.image self.frames[0] self.rect self.image.get_rect(centercenter) self.last_update pygame.time.get_ticks() self.frame_interval 50 # 每帧停留50毫秒 def update(self, *args): now pygame.time.get_ticks() if now - self.last_update self.frame_interval: self.last_update now self.index 1 if self.index len(self.frames): self.kill() else: center self.rect.center self.image self.frames[self.index] self.rect self.image.get_rect(centercenter)这里有个坑每一帧图片尺寸可能不一样如果直接换self.image而不重新计算rect爆炸效果会歪到一边。所以每次换图都要记下原来的中心点重新计算新的rect。这个细节不写出来的话动画看起来会很跳。6. 没有美术也能好看贴图、音效与代码画图6.1 素材加载与convert_alpha的性能差异加载图片最常见的写法是pygame.image.load(plane.png)。这样能用但有个性能隐患默认加载出来的Surface格式可能和显示窗口不一致每次绘制时都要做一次转换。正确的做法是加载之后马上调用.convert_alpha()带透明通道的PNG或.convert()不带透明player_img pygame.image.load(assets/plane.png).convert_alpha()区别有多大我实测过屏幕上有两百个对象时用convert_alpha能把帧率从40多稳定到60。原因就是省掉了每帧几十次的像素格式转换。还有一个前提convert_alpha()必须在pygame.display.set_mode()之后调用。因为像素格式依赖显示模式窗口还没创建时调用会报错。所以代码顺序强制是初始化 → 创建窗口 → 加载图片。6.2 用Surface手搓一架飞机找不到合适的素材或者素材风格不统一完全可以自己画。用pygame.draw系列函数在透明Surface上画图形出来的效果虽然朴素但胜在风格一致、体积为零。下面这个函数直接生成一架俯视角的小飞机用的是三角形机身加两个机翼def make_player_surface(width48, height56): surf pygame.Surface((width, height), pygame.SRCALPHA) cx width // 2 # 机身一个朝上的三角形 body [(cx, 0), (cx 12, height), (cx - 12, height)] pygame.draw.polygon(surf, (90, 170, 255), body) # 两侧机翼 left_wing [(cx - 6, height * 0.4), (0, height * 0.75), (cx - 6, height * 0.8)] right_wing [(cx 6, height * 0.4), (width, height * 0.75), (cx 6, height * 0.8)] pygame.draw.polygon(surf, (60, 130, 220), left_wing) pygame.draw.polygon(surf, (60, 130, 220), right_wing) # 座舱高光 pygame.draw.circle(surf, (230, 245, 255), (cx, int(height * 0.35)), 6) return surfpygame.SRCALPHA这个标志必须加否则Surface不透明画出来的三角形周围会是一块黑底。这个错误我犯过当时还以为是画错了形状其实是透明通道没开。用代码画还有个隐藏好处尺寸随便改。你想让飞机大一点改一下宽高参数就行不用担心图片放大后的锯齿。6.3 音频初始化的静音陷阱音效的坑主要在初始化和混音器参数上。有几种情况会导致代码没报错但就是没声音。第一种是pygame.mixer初始化失败。在某些系统上默认参数可能会失败这时候应该显式指定采样率和缓冲区pygame.mixer.pre_init(frequency44100, size-16, channels2, buffer512) pygame.init()缓冲设小一点512或256能降低音效延迟代价是占用更多CPU。设成4096的话开枪音效会明显滞后于画面手感很差。第二种是WAV和OGG的差别。WAV兼容性最好但体积大OGG体积小且pygame支持良好。MP3在部分平台的pygame版本上支持不稳定能不用就不用。第三种情况比较隐蔽声道被占满。pygame默认的混音通道数是8个。如果你疯狂发射子弹每发都play()一个音效通道很快就被占满后面的音效就静音了。解决办法有两个一是把通道数调大pygame.mixer.set_num_channels(32)二是给音效设置一个最大同时播放数。用Channel对象手动分配会更可控shoot_channel pygame.mixer.Channel(1) shoot_sound pygame.mixer.Sound(assets/shoot.ogg) # 每次发射时 if not shoot_channel.get_busy(): shoot_channel.play(shoot_sound)这样用同一个通道反复播放不会累积占满。听起来可能不够密集但实际游戏里连续射击音效叠在一起反而很吵。7. 我踩过的坑黑屏、卡顿、闪退的真实排查链路7.1 文件路径与中文目录导致的加载异常这是我遇到的第一类问题也是新手最容易中的招。现象是在自己电脑上跑得好好的发给朋友后一启动就报找不到文件或者干脆窗口弹出来就崩。根因通常是相对路径。代码里写pygame.image.load(assets/plane.png)这个路径是相对于当前工作目录解析的不是相对于脚本所在目录。你在项目根目录下用python main.py运行工作目录就是项目根目录一切正常。但如果你在其他目录下运行或者打包之后运行工作目录变了路径就失效了。解决办法是始终用脚本所在位置拼绝对路径import os BASE_DIR os.path.dirname(os.path.abspath(__file__)) def load_image(name): return pygame.image.load(os.path.join(BASE_DIR, assets, name)).convert_alpha()另一个相关问题是中文路径。pygame内部对文件路径的处理依赖底层的SDL部分版本在遇到非ASCII路径时会有编码问题。最稳妥的做法是项目目录和素材文件名全部用英文和数字避开这个雷区。7.2 精灵组遍历中删除元素引发的崩溃这个坑的表现是玩到一半突然闪退而且特别难复现因为只有特定时机才会触发。原因通常是这种写法# 危险写法 for enemy in enemy_group: if enemy.rect.top 700: enemy_group.remove(enemy)在遍历一个集合的同时修改它的长度Python会直接抛RuntimeError或者在某些实现下静默地跳过元素。我在第二版代码里就犯过这个错玩大概三四十秒就会崩一次调试了好久才定位到。正确做法有三种。一是让对象自己决定生死调用self.kill()来移除自己然后遍历结束后统一清理由组内部处理for enemy in list(enemy_group): enemy.update(dt) # update内部判断是否需要kill注意这里的list(...)——把组转成列表再遍历是遍历期间修改原集合的安全方案。二是先收集再统一处理dead [e for e in enemy_group if e.rect.top 700] for e in dead: e.kill()三是用精灵组自带的批量操作比如pygame.sprite.groupcollide(..., True, True)它在内部已经处理好了遍历和删除的顺序你根本不用操心。我现在的习惯是凡是涉及可能被删除的遍历一律加list()包一层。多写四个字符省掉一晚上的调试。7.3 无限生成对象与内存增长游戏跑久了越来越卡最后一卡一卡地死掉。这通常是对象泄漏——某些对象你没销毁它们静静地躺在列表里每帧还在被更新和绘制虽然已经跑到屏幕外面看不到。典型场景是已经飞出屏幕的子弹。如果子弹的更新逻辑里没有自毁判断它们会无限累积。跑五分钟之后几百个看不见的子弹还在占用计算资源。解决办法是在每个移动类的update()里都加越界判断def update(self): self.rect.y - self.speed if self.rect.bottom 0: self.kill()还有一类更隐蔽的图像对象的重复创建。如果每次发射子弹都写pygame.image.load(...)那不仅加载慢还会创建大量无用的Surface对象。正确做法是子弹图像在初始化时加载一次所有子弹共享同一个Surface对象——图像是不可变的共享完全没问题。验证有没有泄漏的办法很简单在循环里加上当前对象的数量统计并打印出来跑两分钟看看数字是不是稳定在一个范围内波动。如果一直往上爬那就是有泄漏。pygame.display.set_caption( f飞机大战 | 敌机 {len(enemy_group)} | 子弹 {len(bullet_group)} )把这个数实时显示在窗口标题上调试的时候特别有用还能顺便看看你的子弹是不是在疯狂堆积。7.4 输入法、键盘重复与窗口失去焦点有几个问题不算bug但很影响体验。第一中文输入法开着的时候方向键可能被输入法截获。玩家按方向键没反应一切都是好的就是飞机不动。这种情况没法在代码里彻底解决只能提醒用户切到英文输入法或者在开始界面加一行提示文字。第二操作系统生成的键盘重复事件。长时间按住某个键系统会以一定频率重复发送KEYDOWN事件。如果你在KEYDOWN分支里写了连续触发的逻辑就会变成按一下发射一堆子弹。这也是为什么发射要用冷却计时器而不是直接响应按键状态。第三窗口失去焦点时的表现。点击到别的窗口再点回来有可能会出现这一个瞬间积累的所有按键事件一起触发的情况导致飞机瞬移。可以在游戏里加个状态判断窗口失去焦点时自动暂停。用pygame.ACTIVEEVENT事件来处理if event.type pygame.ACTIVEEVENT: if event.gain 0: # 失去焦点 paused True这些细节在教程里基本不会提但用户实际玩的时候一定会遇到。8. 让作品能交到别人手上打包与分发8.1 PyInstaller的参数与实际产物游戏写完了最大的分享障碍是对方电脑上没装Python。这时候就需要打包成可执行文件。PyInstaller是这条路里最成熟的工具安装和基本命令pip install pyinstaller # 单文件模式不显示控制台 pyinstaller -F -w main.py几个参数解释一下-F表示打成单个exe文件方便分发但启动会慢一点因为要先解压到临时目录-w表示不显示黑色的命令行窗口游戏当然不需要控制台。如果调试阶段想看到print输出先不要加-w。打包完在dist目录里就能看到exe。但这个exe大概率还不能用——因为素材文件没被打进去运行时会报找不到图片。8.2 资源路径sys._MEIPASS的正确用法PyInstaller的-F模式会把所有东西解压到一个临时目录运行时通过sys._MEIPASS暴露这个路径。所以代码里的资源路径需要做兼容处理import os import sys def resource_path(relative): if hasattr(sys, _MEIPASS): base sys._MEIPASS else: base os.path.dirname(os.path.abspath(__file__)) return os.path.join(base, relative)这样开发时用脚本目录打包后用临时解压目录两边都能找到素材。另一个方案是用--add-data参数显式指定要打包的文件夹# Windows 下用分号分隔源和目标 pyinstaller -F -w --add-data assets;assets main.py # macOS / Linux 下用冒号 pyinstaller -F -w --add-data assets:assets main.py注意这个分隔符在不同系统上不一样Windows是分号类Unix是冒号写错了会静默失败——素材没打进去但不报错等你运行的时候才发现找不到文件。这个坑我踩过排查了半天才发现是分号写成了冒号。8.3 跨平台打包的现实差距有个必须说清楚的事实PyInstaller不支持跨平台打包。在Windows上打包出来的是exe只能在Windows跑要给macOS用户得在macOS上打包要给别人手机上玩PyInstaller完全做不到那是另一个技术路线了。还有个常见现象是杀毒软件误报。因为PyInstaller打包出来的文件结构和某些恶意软件的打包方式相似部分杀毒软件会直接隔离。遇到这种情况可以尝试加--noupx参数禁用压缩或者用代码签名证书个人项目一般用不上再或者干脆提供源码让对方自己跑。包体积也是个现实问题。一个简单的飞机大战打包出来往往有20到40MB因为把Python解释器和pygame的依赖全塞进去了。如果想让体积小一点可以考虑用虚拟环境打包只装必要的依赖避免把无关的库带进去。最后分享一个我一直在用的习惯打包的时候带上版本号和日期比如airplane-v1.2-20240520.exe。改过几版之后你会庆幸自己当初这么做了——不然看着一堆main.exe根本分不清哪个是哪个。至于代码组织我个人习惯是把游戏逻辑拆成main.py主循环和状态管理、sprites.py所有精灵类、settings.py窗口尺寸、速度、颜色等常量、assets/目录图片和音效。这套结构在项目还小的时候看着有点多余但只要你想加个Boss、想换个主题皮肤立刻就能体会到好处——改常量不用翻主逻辑换素材不用改代码。写游戏最怕的就是所有东西搅在一起改一处崩三处那种体验比从头重写还累。
Python pygame飞机大战：游戏循环、碰撞检测与打包分发实战
第一次用Python写出一个能动能打、还能记分的游戏那种成就感和跑通一个爬虫脚本完全不是一回事。飞机大战这个题目在入门圈子里被翻来覆去地讲但绝大多数教程只给你一堆能跑的代码不告诉你为什么这么写、改一行会崩在哪里、为什么自己的版本一开就黑屏。我前后用pygame重写过三个版本的飞机大战从最早那个满屏bug的版本到后来能打包发给朋友玩的成品中间踩的坑足够写一篇长文。这篇内容就是把这些年攒下来的经验一次讲清楚一个完整的Python飞机大战需要哪些模块、每个模块背后的设计理由是什么、素材和音效怎么处理、打包时分发会遇到什么问题。它适合刚学完Python基础语法、想找个项目把知识串起来的人也适合写过一点小游戏但总觉得代码一团乱的人。看完你应该能独立写出一个结构清晰、能跑能改、还能发给别人玩的版本而不是只会复制粘贴三十行源码。1. 为什么飞机大战值得用Python从头写一遍1.1 它把游戏开发该有的要素全占了很多人选练手项目的时候会纠结贪吃蛇太简单俄罗斯方块逻辑又绕。飞机大战刚好卡在中间——它的机制不多但每一个都触及了游戏开发的核心问题。你至少得处理这几件事实时输入键盘按住不放要连续移动、对象生命周期子弹飞出去要销毁敌机被击中要消失、碰撞判定矩形重叠检测、状态管理开始界面、游戏中、结算界面切换、时间控制帧率锁定否则游戏在不同电脑上快慢不一。这五个问题在你的第二个、第三个项目里还会反复出现提前在这个题目上把它们想明白后面写任何小游戏都是换皮。再说得直白一点飞机大战最大的价值不是能做出来而是做出来之后你能看出自己代码的毛病。我第一版把玩家、敌机、子弹的逻辑全部塞在主循环里两百多行代码改一个敌机速度要翻三个地方加一个 Boss 就得重写。第二版改成面向对象之后敌机子类继承一下就能多出三种行为。这个过程本身就是最有价值的收获。1.2 别急着抄源码先说清楚抄的正确姿势网上流传的飞机大战源码多到离谱随手一搜就是几十份标题还都写着完整可运行。我的建议是第一份代码一定自己写哪怕写得丑第二份开始再去看别人的实现重点看类的划分方式和主循环的写法。原因很简单——飞机大战真正的难点不在语法而在把一堆需求翻译成代码结构的能力。你抄来的代码大概率能跑但当你想把敌机从直线下落改成左右摆动时如果连自己都不清楚速度向量存在哪个变量里改起来就是灾难。我见过太多人拿着现成源码改了半天最后改成了一堆互相打架的补丁连自己都读不懂。所以这篇内容不会给你一份可以无脑粘贴的完整代码而是按为什么这样设计的顺序把每一层拆开讲。你可以边看边写写完一段跑一段这样出问题的时候你能立刻定位到是哪一段引入的。2. 图形库怎么选pygame、arcade与tkinter的取舍逻辑2.1 三套方案的横向对比Python做2D游戏能用的库其实就那几个。我在不同项目里都用过先把差别摆出来你再决定要不要跟着走。方案上手难度性能表现生态与资料适合场景pygame低中等60帧小游戏足够极其丰富中文资料多2D小游戏、教学、原型arcade中较好基于OpenGL资料偏少更新活跃度一般需要更多绘制特效的项目tkinter Canvas低差大量对象会卡内置无需安装只画静态图或极简交互pyglet中高好文档英文为主想深入底层的人结论很明确练手项目选pygame。它的接口设计直白Surface、Rect、Sprite这几个概念一遍就能懂遇到问题搜中文也有一大堆答案。arcade虽然API更现代但当你卡在某个奇怪报错上时能搜到的中文结果可能只有个位数对新手很不友好。tkinter的问题是性能——它原本是给表单和按钮设计的你往上贴几百个图像对象帧率会直接掉下来。2.2 帧与事件循环游戏脚本和普通脚本的分水岭这是我觉得最该先讲清楚的一点。你之前写的Python脚本大概是这样的从头到尾执行一遍结束。游戏不是。游戏是一个无限循环每一轮循环叫做一帧。一帧里要做的事固定就那么几步先把这一帧发生的所有事件读出来按键、鼠标、关闭窗口然后根据输入更新所有对象的位置和状态接着把整个画面重新画一遍最后等一小会儿让帧率保持稳定。这个顺序不能乱。如果你先更新再读事件那这一帧的按键要等到下一帧才生效操作会有一帧延迟快速移动时会明显感觉跟不上手。如果你先画图再更新位置那画面永远显示的是上一帧的状态同样是延迟。pygame里正确的骨架长这样import pygame import sys pygame.init() screen pygame.display.set_mode((480, 700)) clock pygame.time.Clock() running True while running: # 1. 处理事件 for event in pygame.event.get(): if event.type pygame.QUIT: running False # 2. 更新对象状态 # 3. 绘制画面 # 4. 刷新显示并控制帧率 pygame.display.flip() clock.tick(60) pygame.quit() sys.exit()pygame.display.flip()和clock.tick(60)这两行是新手最容易漏的。前者负责把你在内存里画好的画面真正推到屏幕上漏了就是一片黑后者负责把循环速度压在每秒60次漏了你的飞机就会快到看不见——因为循环会以CPU的最大速度疯狂执行。我第一次写的时候就是把这两行忘了结果窗口黑屏闪一下就卡死排查了半个小时。2.3 环境准备虚拟环境、pip源与版本坑安装本身不复杂pip install pygame一句话的事。但有几个细节值得提前处理能省掉后面很多麻烦。第一用虚拟环境。别把游戏依赖装进系统Python里。项目做多了之后依赖互相冲突是很常见的事虚拟环境能让你每个项目互不干扰。创建和激活的命令# 创建虚拟环境 python -m venv venv # Windows 激活 venv\Scripts\activate # macOS / Linux 激活 source venv/bin/activate # 安装依赖 pip install pygame第二注意Python版本和pygame版本的匹配。老版本的pygame在Python 3.11以上偶尔会有编译问题建议用较新的pygame 2.x。如果你装的时候看到一堆红色报错、提示找不到某个头文件八成是在尝试从源码编译直接指定版本pip install pygame2.1通常能拿到预编译的轮子包。第三编辑器配置。VS Code Python插件就够了重点是让它识别到你激活的那个虚拟环境。如果写代码时import pygame一直标黄线但运行没问题那就是解释器选错了按CtrlShiftP搜Python: Select Interpreter切一下即可。至于用PyCharm的人在项目设置里把解释器指到venv目录下就行。3. 用对象建模天空玩家机、敌机、子弹该有哪些属性3.1 面向对象拆解的四个角色飞机大战里其实就四个角色玩家机、敌机、子弹、爆炸特效。它们的共同点是都有自己的位置、自己的外观、每帧都要动。差别在于动的规则不同、被谁控制不同。如果不用类你会得到一堆平行的列表enemy_x []、enemy_y []、enemy_speed []然后每次删敌机都要同步删三个列表一旦漏删一个就错位敌机图像和位置对不上看起来像鬼片。这是我第一版代码的真实惨状。用类之后就清爽了每个对象自己管自己的数据列表里只存对象本身。删的时候enemy_list.remove(enemy)一行搞定不会有残留。我建议的类划分是这样的Player只处理键盘输入、位置更新、发射冷却计时Enemy处理下落、随机横向漂移、血量如果要做Bullet只负责匀速上升和越界自毁Explosion只负责播放动画帧序列放完自己删掉分成四个类会不会太碎不会。判断标准是如果两段逻辑的修改原因不同就该分开。敌机的速度和子弹的速度完全是两回事改一个不影响另一个那就该是两个类。3.2 精灵与精灵组pygame.sprite带来的三个便利pygame提供了一套Sprite和Group机制很多人第一次看觉得多余——我自己维护列表不行吗行但用精灵组能白拿三样东西。第一是批量更新和批量绘制。sprite_group.update()会调用组里每个精灵的update()方法sprite_group.draw(screen)会按顺序把每个精灵画到屏幕上。你自己写循环也行但精灵组内部做了不少优化而且省掉一堆样板代码。第二是碰撞检测的现成实现。pygame.sprite.spritecollide(player, enemy_group, False)这一行就能查出玩家和哪些敌机撞了。它内部用的是矩形碰撞但已经帮你处理好了遍历和返回结果比手写双重循环舒服得多。第三是分组管理。你可以把子弹放进bullet_group敌机放进enemy_group然后pygame.sprite.groupcollide(bullet_group, enemy_group, True, True)一行同时完成子弹打中敌机、子弹和敌机都消失这件事。这种表达方式比手动遍历两个列表清晰太多出bug的概率也低。用精灵的标准写法是继承pygame.sprite.Sprite然后至少做三件事调用父类构造函数、设置self.image、设置self.rect。import pygame import random class Enemy(pygame.sprite.Sprite): def __init__(self, image, speed): super().__init__() self.image image self.rect self.image.get_rect() self.rect.x random.randint(0, 480 - self.rect.width) self.rect.y -self.rect.height self.speed speed def update(self, *args): self.rect.y self.speed # 飞出屏幕底部就销毁自己 if self.rect.top 700: self.kill()self.kill()这个方法值得单独说一句——它会把这个精灵从所有它所属的组里移除。这是精灵组机制里最贴心的一处设计意味着你不需要在遍历的时候小心翼翼地删元素只要对象自己判断我该消失了然后调用kill()剩下的交给组去处理。这一点在第7节讲崩溃排查时还会再展开。3.3 坐标系、速度向量与帧率的关系pygame的坐标系有点反直觉原点在窗口左上角x向右增加y向下增加。所以向下落是y speed向上飞是y - speed。刚接触的时候我总想写y - speed表示下落结果敌机全飞天上去了。更关键的是速度值的单位问题。self.rect.y 5这句话的意思是每一帧移动5像素。而帧率是60所以实际速度是每秒300像素。这意味着如果你改了帧率所有物体的速度都会跟着变。假设你一开始用clock.tick(30)敌机设成每帧5像素实际是150像素/秒。后来你觉得画面不够流畅改成60帧忘了改速度敌机立刻变成300像素/秒游戏难度直接翻倍。这就是为什么大型项目里会用delta time两帧之间的时间差来计算位移让速度脱离帧率独立存在。小游戏要不要上delta time我的看法是如果你打算锁定60帧不折腾可以先用固定像素值简单直观但只要你有跨设备分发的打算尽早改成delta time。改法不难把速度定义成每秒多少像素然后乘上clock.tick(60) / 1000.0返回的毫秒数dt clock.tick(60) / 1000.0 # 转成秒 self.rect.y self.speed * dt这样无论帧率怎么变物体每秒移动的距离始终一致。代价是你得把速度值从5改成300这种量级一开始会觉得别扭习惯就好。4. 主循环骨架落地从黑窗口到一架能动的飞机4.1 事件处理的正确姿势事件处理有个经典陷阱用event判断连续按键是错的。pygame.event.get()返回的是这一帧内发生的事情比如某个键被按下了这个动作发生了一次。但玩家按住方向键不放的时候这个动作只会触发一次忽略系统生成的重复事件第二帧就没有了。如果你写成# 错误示范 for event in pygame.event.get(): if event.type pygame.KEYDOWN: if event.key pygame.K_LEFT: player.rect.x - 5那结果就是按一下左键飞机只动5像素。想连续移动得用pygame.key.get_pressed()拿到当前所有键的按下状态在主循环里每帧都查一次keys pygame.key.get_pressed() if keys[pygame.K_LEFT]: player.rect.x - player.speed if keys[pygame.K_RIGHT]: player.rect.x player.speed if keys[pygame.K_UP]: player.rect.y - player.speed if keys[pygame.K_DOWN]: player.rect.y player.speed这个区别是新手最容易忽略的一点。记住分工event处理点按类操作发射子弹、暂停、退出key.get_pressed()处理按住类操作移动。顺带说一个细节如果要实现按住空格连续发射用event配合冷却计时器更容易控制射速用key.get_pressed()会让射速跟着帧率跑容易失控。4.2 渲染顺序与背景滚动的实现绘制是有层级的后画的盖住先画的。正确的顺序是背景图 → 敌机 → 子弹 → 玩家机 → 界面文字。如果把背景放在最后画整个屏幕就只剩背景了。无缝滚动的原理其实很朴素准备两张一样高的背景图一张在屏幕上方y 0一张紧贴在它下面y -高度。每帧两张图都向下移动当上面那张完全移出屏幕底部时把它瞬移到第二张上方然后继续。视觉上就形成了无限滚动。class Background: def __init__(self, image, screen_height): self.image image self.h screen_height self.y1 0 self.y2 -self.h def update(self, dt): self.y1 200 * dt self.y2 200 * dt if self.y1 self.h: self.y1 -self.h if self.y2 self.h: self.y2 -self.h def draw(self, screen): screen.blit(self.image, (0, self.y1)) screen.blit(self.image, (0, self.y2))这里有个容易忽略的点背景图的高度必须大于等于窗口高度否则两张图之间会露出黑色缝隙。如果你的素材是512乘512但窗口是480乘700拉伸一下就变形了正确做法是裁剪或重新找尺寸匹配的素材。4.3 用clock.tick锁帧与delta time的取舍clock.tick(60)这个函数有个容易被忽视的特性它返回上一帧到这一帧经过的毫秒数。所以这句话既是限制帧率又是获取时间差一举两得。问题在于tick限制的是最多60帧如果你的某一帧因为大量碰撞检测卡了80毫秒那这一帧拉长之后物体的位移会按delta time补回来——视觉上会表现为卡顿一下然后物体跳一大段。这是不可避免的只能通过优化碰撞检测的数量来缓解。我的经验是小游戏的碰撞检测对象控制在几十个以内完全没问题一旦超过两三百个子弹同时存在就需要考虑空间划分或者降低检测频率了。具体做法是每两帧才检测一次子弹和敌机视觉上几乎看不出来但计算量减半。另外提醒一句clock.tick()应该放在循环的最后它的作用是睡一小会儿让这一帧凑够16.6毫秒。放在开头会让第一帧的执行时间算进上一帧里导致初期的帧率不稳。5. 射击、碰撞与计分三个让游戏活起来的机制5.1 冷却时间决定射击手感子弹可不是想发就发的。如果每帧都能发射60帧就是每秒60发屏幕瞬间被糊满难度归零。冷却时间cooldown的做法很直接记一个上次发射的时间点每次想发射时算一下距离上次过了多久够长了才允许发射。class Player(pygame.sprite.Sprite): def __init__(self, image, bullet_image, all_group, bullet_group): super().__init__(all_group) self.image image self.rect self.image.get_rect() self.rect.centerx 240 self.rect.bottom 680 self.speed 300 self.bullet_image bullet_image self.bullet_group bullet_group self.last_shot 0 self.shoot_interval 180 # 单位毫秒 def shoot(self, now): if now - self.last_shot self.shoot_interval: self.last_shot now Bullet(self.bullet_image, self.rect.midtop, self.bullet_group)shoot_interval设多少合适这个数字直接决定手感。150到200毫秒大概是密集但不失控的区间也就是每秒5到6发。你可以先设在180跑起来试试觉得不够爽就往下调。注意时间单位统一——如果你用pygame.time.get_ticks()拿时间它是毫秒如果用的是delta time累加那就是秒别混着用否则会出现子弹几乎发不出来或者疯狂连发的极端情况。5.2 rect碰撞、mask碰撞与圆形近似的场景选择pygame默认的碰撞检测是矩形重叠也就是把每个物体的外接矩形拿来比较。这有个众所周知的问题飞机图像的四个角落通常是透明的但矩形检测不管这些所以会出现明明没碰到却判定撞了的憋屈情况。检测方式精度性能适用场景rect重叠低最快子弹、方块类、对精度要求低的场合mask像素级高慢随图像尺寸增长玩家与敌机的判定、Boss战圆形近似中快角色接近圆形、需要距离判定时对飞机大战来说我的做法是子弹对敌机用rect玩家对敌机用mask。子弹细长、数量多用rect够用且快玩家和敌机碰撞一局也就几次性能开销可以忽略但精度体验差距明显。mask碰撞的写法不复杂但有个成本要考虑# 使用 mask 需要事先为每个精灵生成 mask if pygame.sprite.collide_mask(player, enemy): # 撞上了collide_mask会在第一次调用时自动从self.image生成mask并缓存所以第一次调用会稍慢之后就没问题了。但如果你每帧都新建对象比如每次发射子弹都重新加载图像mask会反复生成性能就崩了。图像对象一定在初始化时加载一次反复复用这是铁律。5.3 分数、生命与难度曲线的设计分数和生命值看起来是次要功能但它们决定了游戏能不能让人玩第二遍。分数最直接的做法是击毁一架敌机加固定分。但如果所有敌机都是1分玩家很快就会失去目标感。我的做法是按敌机类型给不同分值小飞机1分中型机5分大型机20分Boss100分。这样玩家会自然地优先攻击高分目标产生策略选择。生命值的常见做法是三条命或者一条命加护盾。第一种更宽容适合新手第二种更紧张。我推荐一条命 受击后1.5秒无敌闪烁理由是这样既不会让玩家因为一次失误就重开又保留了紧张感。无敌状态的实现只需要一个计时器加上奇偶帧显示if self.invincible_until now: # 每隔80毫秒切换一次可见性做出闪烁效果 visible (now // 80) % 2 0 if visible: screen.blit(self.image, self.rect) else: screen.blit(self.image, self.rect)难度曲线我试过几种方案最好用的是随时间线性提升生成频率和下落速度。具体做法是维护一个elapsed累计时间生成敌机的间隔从0.8秒逐渐缩短到0.25秒敌机速度从150逐渐涨到400。关键是给个上限不然玩到三分钟后屏幕上敌机密密麻麻不是难是根本没法玩。spawn_interval max(0.25, 0.8 - elapsed * 0.004) enemy_speed min(400, 150 elapsed * 2)这两个公式里0.004和2这些系数不用死记凭手感调。先跑一局觉得涨得太快就把系数调小。5.4 爆炸动画与对象回收爆炸效果本质上是一组图片按顺序播放。你在初始化时把所有帧加载成一个列表然后按时间切换索引播完调用kill()销毁自己。class Explosion(pygame.sprite.Sprite): def __init__(self, frames, center, group): super().__init__(group) self.frames frames self.index 0 self.image self.frames[0] self.rect self.image.get_rect(centercenter) self.last_update pygame.time.get_ticks() self.frame_interval 50 # 每帧停留50毫秒 def update(self, *args): now pygame.time.get_ticks() if now - self.last_update self.frame_interval: self.last_update now self.index 1 if self.index len(self.frames): self.kill() else: center self.rect.center self.image self.frames[self.index] self.rect self.image.get_rect(centercenter)这里有个坑每一帧图片尺寸可能不一样如果直接换self.image而不重新计算rect爆炸效果会歪到一边。所以每次换图都要记下原来的中心点重新计算新的rect。这个细节不写出来的话动画看起来会很跳。6. 没有美术也能好看贴图、音效与代码画图6.1 素材加载与convert_alpha的性能差异加载图片最常见的写法是pygame.image.load(plane.png)。这样能用但有个性能隐患默认加载出来的Surface格式可能和显示窗口不一致每次绘制时都要做一次转换。正确的做法是加载之后马上调用.convert_alpha()带透明通道的PNG或.convert()不带透明player_img pygame.image.load(assets/plane.png).convert_alpha()区别有多大我实测过屏幕上有两百个对象时用convert_alpha能把帧率从40多稳定到60。原因就是省掉了每帧几十次的像素格式转换。还有一个前提convert_alpha()必须在pygame.display.set_mode()之后调用。因为像素格式依赖显示模式窗口还没创建时调用会报错。所以代码顺序强制是初始化 → 创建窗口 → 加载图片。6.2 用Surface手搓一架飞机找不到合适的素材或者素材风格不统一完全可以自己画。用pygame.draw系列函数在透明Surface上画图形出来的效果虽然朴素但胜在风格一致、体积为零。下面这个函数直接生成一架俯视角的小飞机用的是三角形机身加两个机翼def make_player_surface(width48, height56): surf pygame.Surface((width, height), pygame.SRCALPHA) cx width // 2 # 机身一个朝上的三角形 body [(cx, 0), (cx 12, height), (cx - 12, height)] pygame.draw.polygon(surf, (90, 170, 255), body) # 两侧机翼 left_wing [(cx - 6, height * 0.4), (0, height * 0.75), (cx - 6, height * 0.8)] right_wing [(cx 6, height * 0.4), (width, height * 0.75), (cx 6, height * 0.8)] pygame.draw.polygon(surf, (60, 130, 220), left_wing) pygame.draw.polygon(surf, (60, 130, 220), right_wing) # 座舱高光 pygame.draw.circle(surf, (230, 245, 255), (cx, int(height * 0.35)), 6) return surfpygame.SRCALPHA这个标志必须加否则Surface不透明画出来的三角形周围会是一块黑底。这个错误我犯过当时还以为是画错了形状其实是透明通道没开。用代码画还有个隐藏好处尺寸随便改。你想让飞机大一点改一下宽高参数就行不用担心图片放大后的锯齿。6.3 音频初始化的静音陷阱音效的坑主要在初始化和混音器参数上。有几种情况会导致代码没报错但就是没声音。第一种是pygame.mixer初始化失败。在某些系统上默认参数可能会失败这时候应该显式指定采样率和缓冲区pygame.mixer.pre_init(frequency44100, size-16, channels2, buffer512) pygame.init()缓冲设小一点512或256能降低音效延迟代价是占用更多CPU。设成4096的话开枪音效会明显滞后于画面手感很差。第二种是WAV和OGG的差别。WAV兼容性最好但体积大OGG体积小且pygame支持良好。MP3在部分平台的pygame版本上支持不稳定能不用就不用。第三种情况比较隐蔽声道被占满。pygame默认的混音通道数是8个。如果你疯狂发射子弹每发都play()一个音效通道很快就被占满后面的音效就静音了。解决办法有两个一是把通道数调大pygame.mixer.set_num_channels(32)二是给音效设置一个最大同时播放数。用Channel对象手动分配会更可控shoot_channel pygame.mixer.Channel(1) shoot_sound pygame.mixer.Sound(assets/shoot.ogg) # 每次发射时 if not shoot_channel.get_busy(): shoot_channel.play(shoot_sound)这样用同一个通道反复播放不会累积占满。听起来可能不够密集但实际游戏里连续射击音效叠在一起反而很吵。7. 我踩过的坑黑屏、卡顿、闪退的真实排查链路7.1 文件路径与中文目录导致的加载异常这是我遇到的第一类问题也是新手最容易中的招。现象是在自己电脑上跑得好好的发给朋友后一启动就报找不到文件或者干脆窗口弹出来就崩。根因通常是相对路径。代码里写pygame.image.load(assets/plane.png)这个路径是相对于当前工作目录解析的不是相对于脚本所在目录。你在项目根目录下用python main.py运行工作目录就是项目根目录一切正常。但如果你在其他目录下运行或者打包之后运行工作目录变了路径就失效了。解决办法是始终用脚本所在位置拼绝对路径import os BASE_DIR os.path.dirname(os.path.abspath(__file__)) def load_image(name): return pygame.image.load(os.path.join(BASE_DIR, assets, name)).convert_alpha()另一个相关问题是中文路径。pygame内部对文件路径的处理依赖底层的SDL部分版本在遇到非ASCII路径时会有编码问题。最稳妥的做法是项目目录和素材文件名全部用英文和数字避开这个雷区。7.2 精灵组遍历中删除元素引发的崩溃这个坑的表现是玩到一半突然闪退而且特别难复现因为只有特定时机才会触发。原因通常是这种写法# 危险写法 for enemy in enemy_group: if enemy.rect.top 700: enemy_group.remove(enemy)在遍历一个集合的同时修改它的长度Python会直接抛RuntimeError或者在某些实现下静默地跳过元素。我在第二版代码里就犯过这个错玩大概三四十秒就会崩一次调试了好久才定位到。正确做法有三种。一是让对象自己决定生死调用self.kill()来移除自己然后遍历结束后统一清理由组内部处理for enemy in list(enemy_group): enemy.update(dt) # update内部判断是否需要kill注意这里的list(...)——把组转成列表再遍历是遍历期间修改原集合的安全方案。二是先收集再统一处理dead [e for e in enemy_group if e.rect.top 700] for e in dead: e.kill()三是用精灵组自带的批量操作比如pygame.sprite.groupcollide(..., True, True)它在内部已经处理好了遍历和删除的顺序你根本不用操心。我现在的习惯是凡是涉及可能被删除的遍历一律加list()包一层。多写四个字符省掉一晚上的调试。7.3 无限生成对象与内存增长游戏跑久了越来越卡最后一卡一卡地死掉。这通常是对象泄漏——某些对象你没销毁它们静静地躺在列表里每帧还在被更新和绘制虽然已经跑到屏幕外面看不到。典型场景是已经飞出屏幕的子弹。如果子弹的更新逻辑里没有自毁判断它们会无限累积。跑五分钟之后几百个看不见的子弹还在占用计算资源。解决办法是在每个移动类的update()里都加越界判断def update(self): self.rect.y - self.speed if self.rect.bottom 0: self.kill()还有一类更隐蔽的图像对象的重复创建。如果每次发射子弹都写pygame.image.load(...)那不仅加载慢还会创建大量无用的Surface对象。正确做法是子弹图像在初始化时加载一次所有子弹共享同一个Surface对象——图像是不可变的共享完全没问题。验证有没有泄漏的办法很简单在循环里加上当前对象的数量统计并打印出来跑两分钟看看数字是不是稳定在一个范围内波动。如果一直往上爬那就是有泄漏。pygame.display.set_caption( f飞机大战 | 敌机 {len(enemy_group)} | 子弹 {len(bullet_group)} )把这个数实时显示在窗口标题上调试的时候特别有用还能顺便看看你的子弹是不是在疯狂堆积。7.4 输入法、键盘重复与窗口失去焦点有几个问题不算bug但很影响体验。第一中文输入法开着的时候方向键可能被输入法截获。玩家按方向键没反应一切都是好的就是飞机不动。这种情况没法在代码里彻底解决只能提醒用户切到英文输入法或者在开始界面加一行提示文字。第二操作系统生成的键盘重复事件。长时间按住某个键系统会以一定频率重复发送KEYDOWN事件。如果你在KEYDOWN分支里写了连续触发的逻辑就会变成按一下发射一堆子弹。这也是为什么发射要用冷却计时器而不是直接响应按键状态。第三窗口失去焦点时的表现。点击到别的窗口再点回来有可能会出现这一个瞬间积累的所有按键事件一起触发的情况导致飞机瞬移。可以在游戏里加个状态判断窗口失去焦点时自动暂停。用pygame.ACTIVEEVENT事件来处理if event.type pygame.ACTIVEEVENT: if event.gain 0: # 失去焦点 paused True这些细节在教程里基本不会提但用户实际玩的时候一定会遇到。8. 让作品能交到别人手上打包与分发8.1 PyInstaller的参数与实际产物游戏写完了最大的分享障碍是对方电脑上没装Python。这时候就需要打包成可执行文件。PyInstaller是这条路里最成熟的工具安装和基本命令pip install pyinstaller # 单文件模式不显示控制台 pyinstaller -F -w main.py几个参数解释一下-F表示打成单个exe文件方便分发但启动会慢一点因为要先解压到临时目录-w表示不显示黑色的命令行窗口游戏当然不需要控制台。如果调试阶段想看到print输出先不要加-w。打包完在dist目录里就能看到exe。但这个exe大概率还不能用——因为素材文件没被打进去运行时会报找不到图片。8.2 资源路径sys._MEIPASS的正确用法PyInstaller的-F模式会把所有东西解压到一个临时目录运行时通过sys._MEIPASS暴露这个路径。所以代码里的资源路径需要做兼容处理import os import sys def resource_path(relative): if hasattr(sys, _MEIPASS): base sys._MEIPASS else: base os.path.dirname(os.path.abspath(__file__)) return os.path.join(base, relative)这样开发时用脚本目录打包后用临时解压目录两边都能找到素材。另一个方案是用--add-data参数显式指定要打包的文件夹# Windows 下用分号分隔源和目标 pyinstaller -F -w --add-data assets;assets main.py # macOS / Linux 下用冒号 pyinstaller -F -w --add-data assets:assets main.py注意这个分隔符在不同系统上不一样Windows是分号类Unix是冒号写错了会静默失败——素材没打进去但不报错等你运行的时候才发现找不到文件。这个坑我踩过排查了半天才发现是分号写成了冒号。8.3 跨平台打包的现实差距有个必须说清楚的事实PyInstaller不支持跨平台打包。在Windows上打包出来的是exe只能在Windows跑要给macOS用户得在macOS上打包要给别人手机上玩PyInstaller完全做不到那是另一个技术路线了。还有个常见现象是杀毒软件误报。因为PyInstaller打包出来的文件结构和某些恶意软件的打包方式相似部分杀毒软件会直接隔离。遇到这种情况可以尝试加--noupx参数禁用压缩或者用代码签名证书个人项目一般用不上再或者干脆提供源码让对方自己跑。包体积也是个现实问题。一个简单的飞机大战打包出来往往有20到40MB因为把Python解释器和pygame的依赖全塞进去了。如果想让体积小一点可以考虑用虚拟环境打包只装必要的依赖避免把无关的库带进去。最后分享一个我一直在用的习惯打包的时候带上版本号和日期比如airplane-v1.2-20240520.exe。改过几版之后你会庆幸自己当初这么做了——不然看着一堆main.exe根本分不清哪个是哪个。至于代码组织我个人习惯是把游戏逻辑拆成main.py主循环和状态管理、sprites.py所有精灵类、settings.py窗口尺寸、速度、颜色等常量、assets/目录图片和音效。这套结构在项目还小的时候看着有点多余但只要你想加个Boss、想换个主题皮肤立刻就能体会到好处——改常量不用翻主逻辑换素材不用改代码。写游戏最怕的就是所有东西搅在一起改一处崩三处那种体验比从头重写还累。
