技能介绍

要解决的问题

import pygame 之后，你能很快写出一个能跑的窗口，却很难写出一个行为稳定的游戏。典型症状包括：换台机器速度就变了，按住方向键时快时慢，精灵偶尔凭空消失，窗口标题栏直接变成「未响应」。这些问题大多不是逻辑写错了，而是主循环、时间步和渲染顺序这类底层约定没被遵守。该技能把这几个约定固化成一套最小骨架，让你不必每次从零回忆。

技能如何工作

核心是一条确定的流水线：

选对发行版：项目应建立在 pygame-ce 2.5+ 上——仍在维护的社区分支，导入名同样是 import pygame。同一个环境里不要同时装 pygame 和 pygame-ce，导入冲突很难排查。
初始化与开窗：pygame.init()、pygame.display.set_mode((w, h))，再挂一个 pygame.time.Clock()。
单循环四步：events → update → draw → flip。每帧必须泵一次事件队列，更新状态，重绘，最后 pygame.display.flip()。
时间步解耦：取 dt = clock.tick(60) / 1000（秒），所有位移按 dt 缩放。位置存成浮点数，只在 blit 时转成整数 Rect。
两种输入并行：离散动作走事件（KEYDOWN、MOUSEBUTTONDOWN），持续移动走轮询（pygame.key.get_pressed()）。
对象交给 Sprite + Group：子类化 pygame.sprite.Sprite，以 image 与 rect 为核心属性，之后由 group.update(dt) 和 group.draw(screen) 负责批量更新与绘制。

配套的还有碰撞检测、最小主循环骨架，以及一份踩坑清单：忘了泵事件队列会让窗口假死；按固定量每帧位移会让速度快慢随机器而变；没有调用 .convert() 或 .convert_alpha() 的 Surface 会让 blit 慢到掉帧；斜向移动要先归一化方向向量，否则它天然比单轴移动快。

适用边界

它只覆盖 2D。3D 渲染请另选引擎，与 pygame 无关的 Python 语言问题也不在范围内。跨引擎的存档读写、可重绑的输入架构，应交给专门的 save-systems 与 input-systems。若项目规模超出了 pygame 的表达力，可考虑 Bevy 这类 ECS 引擎；LÖVE/Lua 下的同类骨架见 love2d-core。分组变体、像素级掩码碰撞、精灵图切片、动画与音效等进阶内容，收录在随附的 references/sprites-and-collision.md 中。