如果你写过一个带图形界面的小游戏大概率会遇到这个烦恼窗口做大一点球拍和文字就错位窗口缩小一点小球直接滚到屏幕外面。我最早用Pygame做壁球小游戏时把窗口尺寸写死成 800x600觉得天经地义——结果有一次想演示给别人看对方屏幕比较小整个界面被裁掉一截相当尴尬。后来硬着头皮把窗口做成可拖拽调整大小才发现 Pygame 屏幕绘制机制里藏着一堆细节Surface 要重建、坐标要重新约束、字体要重新加载、球速还得跟着比例变化。这篇文章就以这个“可控制屏幕大小”的壁球小游戏为例子把整套方案从思路到代码完整拆开。适合所有用 Pygame 写小游戏、又被窗口适配折腾过的朋友也适合刚入门、想真正理解 Pygame 绘制循环的初学者。1. 整体设计与思路拆解1.1 壁球游戏的本质和三个“可调整大小”的层次壁球游戏的模型并不复杂一个矩形场地球在墙壁之间反复反弹玩家用球拍接住球漏掉就扣一条命。Pygame 教程里最常见的入门项目里几乎都有它的身影。这个项目虽然简单却天然覆盖了窗口绘制、事件处理、碰撞检测、字体渲染这几个核心知识点拿来研究“屏幕大小可调整”这个问题非常合适。“可控制屏幕大小”这句话在实操里至少有三层含义很多人写代码时只做了第一层用户拖拽窗口边框随意改变窗口尺寸。对应 Pygame 里的pygame.RESIZABLE标志。程序内部动态改变窗口尺寸比如按一个键切换全屏或者通过代码把窗口从 800x600 改成 1024x768。启动游戏之前通过命令行参数或配置文件指定初始窗口大小。这篇文章会把三层都落到实处完整代码支持拖拽调整大小也支持按 F11 切换全屏同时标注了如何用命令行参数控制初始宽高。只做第一层不难难点在于第二层和第三层——每次窗口尺寸一变整个游戏循环里的所有坐标、速度、字体都要跟着重新计算。1.2 Pygame 屏幕绘制机制的底层认知Pygame 里其实没有“屏幕”这个概念只有 Surface。pygame.display.set_mode()返回的那个对象是一块对应窗口客户区的内存画布。你在这块画布上用pygame.draw画圆、画方块、用blit贴文字最后调用pygame.display.flip()把整块画布提交给窗口显示。每一帧都重复这个过程清空、绘制、提交。这个机制可以类比手工翻页动画书。每一帧就是一张新的画纸你在纸上画好这一瞬间的画面然后快速翻过去让人眼产生连续运动的错觉。flip()就是翻页动作。理解了这个底层机制你就会明白一个关键结论窗口大小变化时并不是简单地把窗口拉大就完事。窗口拉大意味着主 Surface 的尺寸变了你需要在事件循环里捕获这个变化用新尺寸重新创建 Surface并且让游戏里所有依赖旧尺寸的坐标、边界、字体重新适配。否则就会出现球卡在窗外、画面残影、字体糊成一团之类的问题。2. 核心细节解析与实操要点2.1 set_mode 参数怎么选从固定窗口到 RESIZABLEpygame.display.set_mode()的完整签名是pygame.display.set_mode(size(0, 0), flags0, depth0, display0, vsync0)。很多人只传第一个参数也就是宽高元组。想支持窗口大小可调整就必须在 flags 参数里加上pygame.RESIZABLE。self.screen pygame.display.set_mode((width, height), pygame.RESIZABLE)RESIZABLE的含义是允许用户拖拽窗口边框改变窗口大小。有了这个标志之后窗口管理器会允许拉伸并且 Pygame 会产生pygame.VIDEORESIZE事件事件的w和h字段会带上新的宽高。真正让窗口尺寸“生效”的是你拿到事件后用新尺寸再调一次set_mode。只打印事件、不重新设置窗口拖拽后画面就会留在旧尺寸的缓冲区里甚至出现错位。另一个常用的 flag 是pygame.FULLSCREEN这个后面讲全屏切换时要用到。还有pygame.DOUBLEBUF它开启双缓冲可以减少画面闪烁。在RESIZABLE模式下如果显卡驱动支持加上DOUBLEBUF更平滑但一般RESIZABLE单独用也够。depth参数默认传 0表示不指定像素深度让 Pygame 自己选一个合适的格式。日常游戏项目保持默认就好。版本在 2.0.3 以上的 Pygameset_mode还支持vsync参数设为 1 可以让窗口提交与显示器刷新率同步减少画面撕裂。想要垂直同步可以这样写self.screen pygame.display.set_mode((width, height), pygame.RESIZABLE, vsync1)注意vsync的实际效果依赖显卡驱动和窗口系统不是所有环境都支持。如果加上后报错说明当前环境不支持去掉vsync参数即可。2.2 事件循环里如何捕捉窗口尺寸变化Pygame 是事件驱动的框架窗口尺寸变化会进入事件队列。事件循环里最常规的做法是在for event in pygame.event.get()中判断event.type pygame.VIDEORESIZE然后读取event.w和event.h调用我们自己的handle_resize方法。for event in pygame.event.get(): if event.type pygame.QUIT: self.running False elif event.type pygame.VIDEORESIZE: self.handle_resize(event.w, event.h)这里有一个很容易踩的坑VIDEORESIZE只是一个“通知”真正让窗口变化生效的是紧接着调用的set_mode。如果你在handle_resize里只修改self.W和self.H不重新调用set_mode那么窗口拖拽时会看到画面被拉伸得很难看或者根本不跟随鼠标。另外Pygame 2.1.3 以后引入了WINDOWRESIZED、WINDOWMAXIMIZED等更精细的窗口事件。但为了兼容旧版本VIDEORESIZE仍然是最稳妥的选择。如果担心某些平台上事件偶尔不触发可以加一道保险在每帧开始时检查self.screen.get_size()是否和当前记录的宽高一致不一致就主动调用handle_resize。这样即使事件丢了画面也能自动纠正。2.3 绘制顺序与双缓冲fill、blit、flip 缺一不可窗口尺寸变化之后新 Surface 的像素内容是未定义的通常是黑屏或者残留之前的内容。如果你只在窗口拖拽后把若干元素画上去没有先填充背景那么扩大窗口后四周会出现各种不可预测的脏像素。所以绘制循环第一步永远是self.screen.fill(BG_COLOR)把整个画布清成指定背景色。第二步是绘制所有游戏对象第三步调用pygame.display.flip()。关于flip和update的区别很多新人容易弄混。flip()是把整块主 Surface 的内容提交到窗口update()则可以只刷新指定的矩形区域性能更好。但窗口变化时你不知道哪些区域变脏了稳妥的做法是用flip()全量刷新。壁球小游戏帧率不高全量刷新完全够用没必要优化到update()。blit是画面上元素的核心方法。文字、图片都要用blit贴到主 Surface 上。它的本质是“把一个 Surface 的像素块复制到另一个 Surface 的指定位置”所以你在绘制面上经常看到self.screen.blit(text_surf, (x, y))这样的写法。2.4 游戏状态的坐标设计不要写死 W 和 H固定窗口时代很多人写出的代码长这样if self.ball.x 800: self.speed_x -self.speed_x窗口一旦变成可调整大小这种代码就是地雷。正确做法是把窗口宽高存成实例变量所有边界计算都从self.W和self.H读取if self.ball_x self.W - self.ball_half: self.speed_x -self.speed_x还有一个细节是坐标类型。Pygame 的Rect只接受整数坐标但球的运动速度是浮点数。如果每帧直接把浮点速度加到Rect.left上小数部分会被截断球的运动会变得一顿一顿。更合理的做法是球的位置用两个浮点数ball_x和ball_y保存每帧累加浮点位移绘制时再转成整数传给pygame.draw.circle。这样既保持了浮点精度又不影响绘制接口。球拍则可以直接用pygame.Rect因为球拍一般只在鼠标位置上左右移动不涉及精细的浮点累积问题。Rect 自带的colliderect碰撞检测很方便后面代码里会用到。3. 实操过程与核心环节实现3.1 环境准备与最简骨架运行环境要求 Python 3.8 以上Pygame 建议 2.0 以上版本。安装方式pip install pygame装好后先跑一个最简骨架确认事件循环和帧率控制正常import pygame pygame.init() screen pygame.display.set_mode((800, 600), pygame.RESIZABLE) clock pygame.time.Clock() running True while running: dt clock.tick(60) / 1000.0 for event in pygame.event.get(): if event.type pygame.QUIT: running False elif event.type pygame.VIDEORESIZE: screen pygame.display.set_mode((event.w, event.h), pygame.RESIZABLE) screen.fill((18, 18, 24)) pygame.display.flip() pygame.quit()这段代码里最有价值的其实是dt。clock.tick(60)会尽量把帧率控制在 60 FPS并返回上一帧消耗的毫秒数。除以 1000 变成秒后物体的运动速度就可以用“像素/秒”来定义而不是“像素/帧”。这个习惯一定要养成否则帧率波动时游戏速度会忽快忽慢。3.2 完整的壁球小游戏代码下面就是核心交付内容。这份代码实现了可拖拽调整窗口大小、F11 全屏切换、命令行指定初始尺寸、鼠标控制球拍、点击或空格发球、漏球扣命、计分和接球反弹角度控制。所有跟窗口尺寸相关的适配逻辑都集中在handle_resize、_apply_scale和_clamp_objects三个方法里方便阅读。 壁球小游戏可调整窗口大小 操作鼠标移动球拍鼠标左键或空格发球F11 切换全屏拖拽窗口边框调整大小 import argparse import sys import pygame DEFAULT_W, DEFAULT_H 800, 600 MIN_W, MIN_H 320, 240 BG_COLOR (18, 18, 24) FG_COLOR (235, 235, 235) BALL_COLOR (255, 180, 60) PADDLE_COLOR (90, 200, 160) TEXT_COLOR (235, 235, 235) BALL_SIZE 16 PADDLE_WIDTH 100 PADDLE_HEIGHT 12 PADDLE_BOTTOM_OFFSET 24 BALL_BASE_SPEED 240 class Game: def __init__(self, width, height): pygame.init() pygame.display.set_caption(壁球 - 可调整窗口大小) self.screen pygame.display.set_mode((width, height), pygame.RESIZABLE) self.clock pygame.time.Clock() self.running True self.W width self.H height self.scale 1.0 self.ball_x width / 2 self.ball_y height / 2 self.ball_half BALL_SIZE / 2 self.speed_x BALL_BASE_SPEED self.speed_y -BALL_BASE_SPEED self.paddle pygame.Rect(0, 0, PADDLE_WIDTH, PADDLE_HEIGHT) self.paddle.midbottom (width / 2, height - PADDLE_BOTTOM_OFFSET) self.launched False self.score 0 self.lives 3 self.font None self.font_small None self.is_fullscreen False self._reload_fonts() self._apply_scale() self._clamp_objects() def _reload_fonts(self): size max(18, self.H // 22) self.font pygame.font.Font(None, size) self.font_small pygame.font.Font(None, max(16, size - 6)) def _apply_scale(self): base min(DEFAULT_W, DEFAULT_H) current min(self.W, self.H) self.scale current / base def _clamp_objects(self): self.ball_x max(self.ball_half, min(self.W - self.ball_half, self.ball_x)) self.ball_y max(self.ball_half, min(self.H - self.ball_half, self.ball_y)) if self.paddle.left 0: self.paddle.left 0 if self.paddle.right self.W: self.paddle.right self.W self.paddle.bottom self.H - PADDLE_BOTTOM_OFFSET def handle_resize(self, new_w, new_h): new_w max(MIN_W, new_w) new_h max(MIN_H, new_h) old_scale self.scale self.W, self.H new_w, new_h self.screen pygame.display.set_mode((new_w, new_h), pygame.RESIZABLE) self._reload_fonts() self._apply_scale() ratio self.scale / old_scale self.speed_x * ratio self.speed_y * ratio self._clamp_objects() def toggle_fullscreen(self): self.is_fullscreen not self.is_fullscreen if self.is_fullscreen: self.screen pygame.display.set_mode((0, 0), pygame.FULLSCREEN) w, h self.screen.get_size() self.W, self.H w, h else: self.screen pygame.display.set_mode((self.W, self.H), pygame.RESIZABLE) self._reload_fonts() self._apply_scale() self._clamp_objects() def reset_ball(self): self.ball_x self.W / 2 self.ball_y self.H / 2 self.speed_x BALL_BASE_SPEED * self.scale self.speed_y -BALL_BASE_SPEED * self.scale self.launched False def launch_ball(self): if not self.launched: self.launched True def update(self, dt): mouse_x, _ pygame.mouse.get_pos() self.paddle.centerx mouse_x if self.paddle.left 0: self.paddle.left 0 if self.paddle.right self.W: self.paddle.right self.W self.paddle.bottom self.H - PADDLE_BOTTOM_OFFSET if not self.launched: self.ball_x self.paddle.centerx self.ball_y self.paddle.top - self.ball_half return self.ball_x self.speed_x * dt self.ball_y self.speed_y * dt if self.ball_x self.ball_half or self.ball_x self.W - self.ball_half: self.speed_x -self.speed_x self.ball_x max(self.ball_half, min(self.W - self.ball_half, self.ball_x)) if self.ball_y self.ball_half: self.speed_y -self.speed_y self.ball_y self.ball_half if self.speed_y 0: ball_rect pygame.Rect( int(self.ball_x - self.ball_half), int(self.ball_y - self.ball_half), BALL_SIZE, BALL_SIZE, ) if ball_rect.colliderect(self.paddle): self.speed_y -abs(self.speed_y) offset (self.ball_x - self.paddle.centerx) / (self.paddle.width / 2) self.speed_x BALL_BASE_SPEED * self.scale * max(0.5, abs(offset) 0.3) if offset 0: self.speed_x -abs(self.speed_x) elif offset 0: self.speed_x abs(self.speed_x) self.score 1 self.ball_y self.paddle.top - self.ball_half if self.ball_y self.H - self.ball_half: self.lives - 1 if self.lives 0: self.running False else: self.reset_ball() def draw(self): self.screen.fill(BG_COLOR) pygame.draw.rect(self.screen, FG_COLOR, pygame.Rect(0, 0, self.W, self.H), width2) pygame.draw.rect(self.screen, PADDLE_COLOR, self.paddle, border_radius4) pygame.draw.circle( self.screen, BALL_COLOR, (int(self.ball_x), int(self.ball_y)), int(self.ball_half), ) text_surf self.font.render(fScore: {self.score} Lives: {self.lives}, True, TEXT_COLOR) self.screen.blit(text_surf, (10, 6)) if not self.launched: tip_surf self.font_small.render(Click or press Space to launch, True, TEXT_COLOR) self.screen.blit( tip_surf, (self.W // 2 - tip_surf.get_width() // 2, self.H // 2 - tip_surf.get_height() // 2), ) pygame.display.flip() def run(self): while self.running: dt self.clock.tick(60) / 1000.0 dt min(dt, 0.05) for event in pygame.event.get(): if event.type pygame.QUIT: self.running False elif event.type pygame.VIDEORESIZE: self.handle_resize(event.w, event.h) elif event.type pygame.KEYDOWN: if event.key pygame.K_SPACE: self.launch_ball() elif event.key pygame.K_F11: self.toggle_fullscreen() elif event.type pygame.MOUSEBUTTONDOWN: if event.button 1: self.launch_ball() self.update(dt) self.draw() pygame.quit() def parse_args(): parser argparse.ArgumentParser(description壁球小游戏 - 可调整窗口大小) parser.add_argument(--width, typeint, defaultDEFAULT_W, help初始窗口宽度) parser.add_argument(--height, typeint, defaultDEFAULT_H, help初始窗口高度) return parser.parse_args() if __name__ __main__: args parse_args() game Game(args.width, args.height) game.run() sys.exit()3.3 窗口大小变化时代码到底做了什么窗口尺寸变化后游戏绝不能只是“换一块更大的画布”。我把自适应逻辑拆成四个动作对应代码里的四个方法第一重建主 Surface。handle_resize里调用set_mode((new_w, new_h), pygame.RESIZABLE)这是唯一能让窗口真正改变大小的操作。注意new_w和new_h用max(MIN_W, new_w)限制了一下防止用户把窗口缩成一个点导致后续所有除法运算和矩形操作都变得不正常。第二重载字体。pygame.font.Font(None, size)在创建时就确定了字体像素大小窗口变大后如果还沿用旧字体字就会显得小气。_reload_fonts里用self.H // 22计算字号同样限制了下限为 18保证窗口再小也能看清文字。这里的关键是“重载”而不是“缩放”——把一个小字号 Surface 用pygame.transform.scale放大字体会糊边缘全是锯齿效果很差。第三调整速度比例。_apply_scale用当前窗口短边和初始窗口短边的比值计算出一个速度缩放系数。窗口变小球速随之变慢否则小球在很小的窗口里横冲直撞玩家根本反应不过来。窗口变大球速适当变快避免游戏变得过于拖沓。handle_resize里先记下old_scale再计算新scale最后用两者比值修正当前球的实时速度。这样无论在发球前还是发球后拖拽窗口球速都是连续变化的不会出现突然飞走或突然停住。第四约束物体坐标。_clamp_objects把球和球拍限制在窗口边界内。窗口缩小后球原本在窗外这个函数会把球拉回窗内并把它“夹住”在合法范围内。球拍同理如果球拍在缩小后的窗口右侧外面就把它的right拉回self.W。这四个动作一个都不能少。只重建 Surface 不调字体文字大小对不上只调速度不管坐标小球会消失只管坐标不调速度游戏难度和窗口尺寸完全不匹配。3.4 坐标自适应方案对比像素坐标 vs 归一化坐标处理窗口尺寸自适应业界常见的思路有两种。方案 A 是直接使用当前窗口像素坐标这也是上面代码采用的方式。球的位置、球拍的位置都以实际的self.W和self.H为基准窗口变化时重新计算边界并约束位置。优点是逻辑直观调试方便碰撞检测直接对齐显示区域适合壁球这类对象少、规则简单的游戏。方案 B 是游戏逻辑层使用归一化坐标也就是所有位置都存储在 0 到 1 之间的小数绘制时才乘以当前窗口宽高。比如球的位置存储为norm_x 0.5绘制时ball_x norm_x * self.W。这种方案的好处是窗口无论怎么变逻辑层几乎不用改动天然适配任意分辨率。代价是每次绘制都要做一次乘法换算而且碰撞检测、宽度、大小这些参数也要全部归一化理解门槛更高。对于壁球小游戏我个人推荐方案 A。Pygame 的Rect和draw系列函数本身就是基于像素坐标设计的用归一化坐标反而绕弯。等将来你做真正的引擎级项目再考虑方案 B 不迟。4. 常见问题与排查技巧实录4.1 窗口缩小后球“卡”在窗外这是缩放事件最典型的 bug。现象是窗口拖小之后球的一部分或者整个球在可视区域外面玩家看不到球但游戏还在继续球还在跟边界碰撞。原因很简单VIDEORESIZE事件来了之后只更新了self.W和self.H重新创建了 Surface但球的坐标还是之前那么大。窗口缩到比球的横坐标还小球自然就在窗外。解决办法就是在尺寸更新后立刻执行_clamp_objects把所有物体的坐标硬塞回新边界内。调试时可以先在handle_resize里把新尺寸和球的位置一起打印出来马上就能看出坐标有没有越界。4.2 拖动窗口时画面残影、错位表现是窗口拉伸过程中画面像是被涂改过一样部分区域颜色错误物体拖出残影。绝大多数情况下这是因为新 Surface 创建后没有全量重绘。flip()是全量提交但如果你在代码里用了display.update(rect)局部刷新或者其他绘制优化手段窗口尺寸变化时“脏矩形”的预估就会失灵。比如旧画面的某个角落没有重画新窗口扩大后那片区域就残留着上一帧的内容。解决方式很直接每次窗口变化时确保完整走一遍fill背景 绘制所有元素 flip()的流程。拖拽尺寸期间帧率会掉但画面不会坏这就是赢了。4.3 窗口变大后游戏变慢变小后变快如果你在代码里写的是self.ball_x 3这种“每帧固定移动 3 像素”那窗口尺寸变化后游戏速度一定不对。窗口变宽球从一边到另一边需要的帧数变多观察上球变慢了窗口变窄同样的像素增量让球显得更快。解决方法是把速度单位改成“像素/秒”每帧位移是speed * dt。其次窗口尺寸变化后球速还要按当前窗口尺寸与初始尺寸的比例做缩放。这就是_apply_scale的作用。没有这一步你只会得到“速度跟随时间稳定、但在不同窗口尺寸下游戏难度不一致”的结果。4.4 字体变糊或者完全没变Pygame 渲染文字时字体大小在Font对象创建那一刻就固定了。如果你把一个小号字体渲染出来的 Surface 用pygame.transform.scale放大边缘一定糊。还有更隐蔽的情况窗口变化后依然用旧Font对象渲染字号不变小窗口里字显得特别大大窗口里字显得特别小。处理方式是每次handle_resize时基于新窗口高度重新创建Font而不是缩放渲染结果。窗口越大字号越大窗口越小字号跟着变小同时设置下限保证可读性。4.5 常见问题排查速查表现象可能原因解决方案球在窗口缩小后消失缩小时没有约束坐标resize 后调用_clamp_objects拖拽窗口出现残影错位只局部刷新没有全量重绘完整走 fill 绘制 flip窗口大小变化后球速异常速度是像素/帧或者没有缩放比例改用speed * dt并动态调整 scale字体模糊缩放 Surface 而不是重载 Fontresize 时重新创建Font对象全屏切换后画面错乱全屏后没重新设置 W/H 和字体复用 shrink 那套逻辑处理全屏VIDEORESIZE 事件没触发平台差异或事件被吞每帧检查screen.get_size()做兜底第五条值得展开说。全屏切换时set_mode((0, 0), pygame.FULLSCREEN)会让 Pygame 自动选择当前显示器分辨率。你自己以为还是原来的 800x600其实窗口已经变了。所以在toggle_fullscreen里切换完成之后要立刻重新读取self.screen.get_size()再走一遍_reload_fonts和_clamp_objects。很多人在全屏后遇到“画面只占屏幕一半”“球跑到屏幕外”基本都是忽略了这个步骤。5. 扩展方式与实操心得5.1 命令行控制初始窗口大小代码里已经通过argparse支持命令行参数了。实际运行方式python squash.py --width 1024 --height 768这个能力在录制演示视频、或者要在不同设备上演示时非常有用。命令行参数的逻辑并不复杂就是解析--width和--height然后传给Game构造函数。作为游戏开发者把窗口尺寸做成可以命令行注入的输入而不是代码里的魔法常量算是一个非常好的习惯。5.2 全屏切换和 RESIZABLE 的联动全屏模式有一个容易忽略的点从全屏切回窗口模式时最好把窗口尺寸恢复到切全屏之前的值。我代码里在toggle_fullscreen中切回窗口时用的是self.W和self.H。但切全屏时我把self.W和self.H改成了显示器的实际分辨率所以这里要做一点额外处理才不会丢失用户原来的窗口大小。具体做法是在切全屏前备份原始窗口宽高if not self.is_fullscreen: self.windowed_w self.W self.windowed_h self.H self.screen pygame.display.set_mode((0, 0), pygame.FULLSCREEN) else: self.screen pygame.display.set_mode((self.windowed_w, self.windowed_h), pygame.RESIZABLE)上面完整代码里我没有放这个备份是为了让主逻辑更精简。实际项目中强烈建议加上否则用户来回切换几次全屏窗口尺寸会丢失记忆。5.3 做简单的 Model / View 分离壁球游戏现在用一个Game类托管全部逻辑可以运行但如果你打算继续加功能比如双人模式、多球、道具系统建议把“游戏状态计算”和“绘制显示”分开。简单做法是抽出两个模块一个是纯逻辑的Ball类只管坐标、速度、边界检测完全不知道 Pygame 的绘制函数存在另一个是Renderer类负责把Ball的坐标画到屏上。这样做的好处是逻辑层可以直接写单元测试不依赖窗口系统窗口适配的测试成本会大幅降低。等游戏复杂度上来以后你会发现这种拆分带来的收益远大于那一点前期额外代码量。5.4 实操中沉淀的一些经验最后分享几点我自己在项目里反复踩坑后总结的经验。尺寸相关的常量一律从窗口属性读取。写死 800、600 这种数字是新手最容易犯的错一旦窗口可调整这些魔法常量全部要清一遍。浮点位置和 Rect 整数的关系建议“逻辑用浮点、碰撞用 Rect”。球的中心点用 float每帧累加时精度高碰撞检测时临时构造一个pygame.Rect交给colliderect判断。这样既避免了整数取整导致移动卡顿又享受了 Rect 带来的便捷碰撞 API。dt一定要做上限钳制。窗口拖拽、全屏切换的一瞬间帧率可能剧烈波动如果某一帧dt是 0.3 秒球可能直接穿过球拍。dt min(dt, 0.05)这个小操作能避免很多奇葩物理问题。调试窗口事件时先打印再处理。我在写这个项目时发现VIDEORESIZE事件在不同的窗口管理下表现不完全一样有的系统拖拽过程中连续触发几十次有的只触发一次。调试阶段先print(event)把所有事件流看清楚再写对应的处理逻辑能节省大量猜测时间。如果你准备把这个项目继续扩展后续方向其实很多给球增加随机反弹角度、加入道具系统、换成双人对战模式、或者把窗口尺寸适配逻辑抽成通用工具类复用到下一个 Pygame 项目里。窗口大小可控制这件事看起来只是一个细节但它几乎触碰了 Pygame 绘制机制的每一根神经。把这块吃透了再回头写固定尺寸的小游戏你会觉得思路清晰得多。 
长河君 · 2026/10/21 13:19:38 · 阅读 1.2k Pygame窗口自适应实战：可调整大小的壁球游戏完整实现
如果你写过一个带图形界面的小游戏大概率会遇到这个烦恼窗口做大一点球拍和文字就错位窗口缩小一点小球直接滚到屏幕外面。我最早用Pygame做壁球小游戏时把窗口尺寸写死成 800x600觉得天经地义——结果有一次想演示给别人看对方屏幕比较小整个界面被裁掉一截相当尴尬。后来硬着头皮把窗口做成可拖拽调整大小才发现 Pygame 屏幕绘制机制里藏着一堆细节Surface 要重建、坐标要重新约束、字体要重新加载、球速还得跟着比例变化。这篇文章就以这个“可控制屏幕大小”的壁球小游戏为例子把整套方案从思路到代码完整拆开。适合所有用 Pygame 写小游戏、又被窗口适配折腾过的朋友也适合刚入门、想真正理解 Pygame 绘制循环的初学者。1. 整体设计与思路拆解1.1 壁球游戏的本质和三个“可调整大小”的层次壁球游戏的模型并不复杂一个矩形场地球在墙壁之间反复反弹玩家用球拍接住球漏掉就扣一条命。Pygame 教程里最常见的入门项目里几乎都有它的身影。这个项目虽然简单却天然覆盖了窗口绘制、事件处理、碰撞检测、字体渲染这几个核心知识点拿来研究“屏幕大小可调整”这个问题非常合适。“可控制屏幕大小”这句话在实操里至少有三层含义很多人写代码时只做了第一层用户拖拽窗口边框随意改变窗口尺寸。对应 Pygame 里的pygame.RESIZABLE标志。程序内部动态改变窗口尺寸比如按一个键切换全屏或者通过代码把窗口从 800x600 改成 1024x768。启动游戏之前通过命令行参数或配置文件指定初始窗口大小。这篇文章会把三层都落到实处完整代码支持拖拽调整大小也支持按 F11 切换全屏同时标注了如何用命令行参数控制初始宽高。只做第一层不难难点在于第二层和第三层——每次窗口尺寸一变整个游戏循环里的所有坐标、速度、字体都要跟着重新计算。1.2 Pygame 屏幕绘制机制的底层认知Pygame 里其实没有“屏幕”这个概念只有 Surface。pygame.display.set_mode()返回的那个对象是一块对应窗口客户区的内存画布。你在这块画布上用pygame.draw画圆、画方块、用blit贴文字最后调用pygame.display.flip()把整块画布提交给窗口显示。每一帧都重复这个过程清空、绘制、提交。这个机制可以类比手工翻页动画书。每一帧就是一张新的画纸你在纸上画好这一瞬间的画面然后快速翻过去让人眼产生连续运动的错觉。flip()就是翻页动作。理解了这个底层机制你就会明白一个关键结论窗口大小变化时并不是简单地把窗口拉大就完事。窗口拉大意味着主 Surface 的尺寸变了你需要在事件循环里捕获这个变化用新尺寸重新创建 Surface并且让游戏里所有依赖旧尺寸的坐标、边界、字体重新适配。否则就会出现球卡在窗外、画面残影、字体糊成一团之类的问题。2. 核心细节解析与实操要点2.1 set_mode 参数怎么选从固定窗口到 RESIZABLEpygame.display.set_mode()的完整签名是pygame.display.set_mode(size(0, 0), flags0, depth0, display0, vsync0)。很多人只传第一个参数也就是宽高元组。想支持窗口大小可调整就必须在 flags 参数里加上pygame.RESIZABLE。self.screen pygame.display.set_mode((width, height), pygame.RESIZABLE)RESIZABLE的含义是允许用户拖拽窗口边框改变窗口大小。有了这个标志之后窗口管理器会允许拉伸并且 Pygame 会产生pygame.VIDEORESIZE事件事件的w和h字段会带上新的宽高。真正让窗口尺寸“生效”的是你拿到事件后用新尺寸再调一次set_mode。只打印事件、不重新设置窗口拖拽后画面就会留在旧尺寸的缓冲区里甚至出现错位。另一个常用的 flag 是pygame.FULLSCREEN这个后面讲全屏切换时要用到。还有pygame.DOUBLEBUF它开启双缓冲可以减少画面闪烁。在RESIZABLE模式下如果显卡驱动支持加上DOUBLEBUF更平滑但一般RESIZABLE单独用也够。depth参数默认传 0表示不指定像素深度让 Pygame 自己选一个合适的格式。日常游戏项目保持默认就好。版本在 2.0.3 以上的 Pygameset_mode还支持vsync参数设为 1 可以让窗口提交与显示器刷新率同步减少画面撕裂。想要垂直同步可以这样写self.screen pygame.display.set_mode((width, height), pygame.RESIZABLE, vsync1)注意vsync的实际效果依赖显卡驱动和窗口系统不是所有环境都支持。如果加上后报错说明当前环境不支持去掉vsync参数即可。2.2 事件循环里如何捕捉窗口尺寸变化Pygame 是事件驱动的框架窗口尺寸变化会进入事件队列。事件循环里最常规的做法是在for event in pygame.event.get()中判断event.type pygame.VIDEORESIZE然后读取event.w和event.h调用我们自己的handle_resize方法。for event in pygame.event.get(): if event.type pygame.QUIT: self.running False elif event.type pygame.VIDEORESIZE: self.handle_resize(event.w, event.h)这里有一个很容易踩的坑VIDEORESIZE只是一个“通知”真正让窗口变化生效的是紧接着调用的set_mode。如果你在handle_resize里只修改self.W和self.H不重新调用set_mode那么窗口拖拽时会看到画面被拉伸得很难看或者根本不跟随鼠标。另外Pygame 2.1.3 以后引入了WINDOWRESIZED、WINDOWMAXIMIZED等更精细的窗口事件。但为了兼容旧版本VIDEORESIZE仍然是最稳妥的选择。如果担心某些平台上事件偶尔不触发可以加一道保险在每帧开始时检查self.screen.get_size()是否和当前记录的宽高一致不一致就主动调用handle_resize。这样即使事件丢了画面也能自动纠正。2.3 绘制顺序与双缓冲fill、blit、flip 缺一不可窗口尺寸变化之后新 Surface 的像素内容是未定义的通常是黑屏或者残留之前的内容。如果你只在窗口拖拽后把若干元素画上去没有先填充背景那么扩大窗口后四周会出现各种不可预测的脏像素。所以绘制循环第一步永远是self.screen.fill(BG_COLOR)把整个画布清成指定背景色。第二步是绘制所有游戏对象第三步调用pygame.display.flip()。关于flip和update的区别很多新人容易弄混。flip()是把整块主 Surface 的内容提交到窗口update()则可以只刷新指定的矩形区域性能更好。但窗口变化时你不知道哪些区域变脏了稳妥的做法是用flip()全量刷新。壁球小游戏帧率不高全量刷新完全够用没必要优化到update()。blit是画面上元素的核心方法。文字、图片都要用blit贴到主 Surface 上。它的本质是“把一个 Surface 的像素块复制到另一个 Surface 的指定位置”所以你在绘制面上经常看到self.screen.blit(text_surf, (x, y))这样的写法。2.4 游戏状态的坐标设计不要写死 W 和 H固定窗口时代很多人写出的代码长这样if self.ball.x 800: self.speed_x -self.speed_x窗口一旦变成可调整大小这种代码就是地雷。正确做法是把窗口宽高存成实例变量所有边界计算都从self.W和self.H读取if self.ball_x self.W - self.ball_half: self.speed_x -self.speed_x还有一个细节是坐标类型。Pygame 的Rect只接受整数坐标但球的运动速度是浮点数。如果每帧直接把浮点速度加到Rect.left上小数部分会被截断球的运动会变得一顿一顿。更合理的做法是球的位置用两个浮点数ball_x和ball_y保存每帧累加浮点位移绘制时再转成整数传给pygame.draw.circle。这样既保持了浮点精度又不影响绘制接口。球拍则可以直接用pygame.Rect因为球拍一般只在鼠标位置上左右移动不涉及精细的浮点累积问题。Rect 自带的colliderect碰撞检测很方便后面代码里会用到。3. 实操过程与核心环节实现3.1 环境准备与最简骨架运行环境要求 Python 3.8 以上Pygame 建议 2.0 以上版本。安装方式pip install pygame装好后先跑一个最简骨架确认事件循环和帧率控制正常import pygame pygame.init() screen pygame.display.set_mode((800, 600), pygame.RESIZABLE) clock pygame.time.Clock() running True while running: dt clock.tick(60) / 1000.0 for event in pygame.event.get(): if event.type pygame.QUIT: running False elif event.type pygame.VIDEORESIZE: screen pygame.display.set_mode((event.w, event.h), pygame.RESIZABLE) screen.fill((18, 18, 24)) pygame.display.flip() pygame.quit()这段代码里最有价值的其实是dt。clock.tick(60)会尽量把帧率控制在 60 FPS并返回上一帧消耗的毫秒数。除以 1000 变成秒后物体的运动速度就可以用“像素/秒”来定义而不是“像素/帧”。这个习惯一定要养成否则帧率波动时游戏速度会忽快忽慢。3.2 完整的壁球小游戏代码下面就是核心交付内容。这份代码实现了可拖拽调整窗口大小、F11 全屏切换、命令行指定初始尺寸、鼠标控制球拍、点击或空格发球、漏球扣命、计分和接球反弹角度控制。所有跟窗口尺寸相关的适配逻辑都集中在handle_resize、_apply_scale和_clamp_objects三个方法里方便阅读。 壁球小游戏可调整窗口大小 操作鼠标移动球拍鼠标左键或空格发球F11 切换全屏拖拽窗口边框调整大小 import argparse import sys import pygame DEFAULT_W, DEFAULT_H 800, 600 MIN_W, MIN_H 320, 240 BG_COLOR (18, 18, 24) FG_COLOR (235, 235, 235) BALL_COLOR (255, 180, 60) PADDLE_COLOR (90, 200, 160) TEXT_COLOR (235, 235, 235) BALL_SIZE 16 PADDLE_WIDTH 100 PADDLE_HEIGHT 12 PADDLE_BOTTOM_OFFSET 24 BALL_BASE_SPEED 240 class Game: def __init__(self, width, height): pygame.init() pygame.display.set_caption(壁球 - 可调整窗口大小) self.screen pygame.display.set_mode((width, height), pygame.RESIZABLE) self.clock pygame.time.Clock() self.running True self.W width self.H height self.scale 1.0 self.ball_x width / 2 self.ball_y height / 2 self.ball_half BALL_SIZE / 2 self.speed_x BALL_BASE_SPEED self.speed_y -BALL_BASE_SPEED self.paddle pygame.Rect(0, 0, PADDLE_WIDTH, PADDLE_HEIGHT) self.paddle.midbottom (width / 2, height - PADDLE_BOTTOM_OFFSET) self.launched False self.score 0 self.lives 3 self.font None self.font_small None self.is_fullscreen False self._reload_fonts() self._apply_scale() self._clamp_objects() def _reload_fonts(self): size max(18, self.H // 22) self.font pygame.font.Font(None, size) self.font_small pygame.font.Font(None, max(16, size - 6)) def _apply_scale(self): base min(DEFAULT_W, DEFAULT_H) current min(self.W, self.H) self.scale current / base def _clamp_objects(self): self.ball_x max(self.ball_half, min(self.W - self.ball_half, self.ball_x)) self.ball_y max(self.ball_half, min(self.H - self.ball_half, self.ball_y)) if self.paddle.left 0: self.paddle.left 0 if self.paddle.right self.W: self.paddle.right self.W self.paddle.bottom self.H - PADDLE_BOTTOM_OFFSET def handle_resize(self, new_w, new_h): new_w max(MIN_W, new_w) new_h max(MIN_H, new_h) old_scale self.scale self.W, self.H new_w, new_h self.screen pygame.display.set_mode((new_w, new_h), pygame.RESIZABLE) self._reload_fonts() self._apply_scale() ratio self.scale / old_scale self.speed_x * ratio self.speed_y * ratio self._clamp_objects() def toggle_fullscreen(self): self.is_fullscreen not self.is_fullscreen if self.is_fullscreen: self.screen pygame.display.set_mode((0, 0), pygame.FULLSCREEN) w, h self.screen.get_size() self.W, self.H w, h else: self.screen pygame.display.set_mode((self.W, self.H), pygame.RESIZABLE) self._reload_fonts() self._apply_scale() self._clamp_objects() def reset_ball(self): self.ball_x self.W / 2 self.ball_y self.H / 2 self.speed_x BALL_BASE_SPEED * self.scale self.speed_y -BALL_BASE_SPEED * self.scale self.launched False def launch_ball(self): if not self.launched: self.launched True def update(self, dt): mouse_x, _ pygame.mouse.get_pos() self.paddle.centerx mouse_x if self.paddle.left 0: self.paddle.left 0 if self.paddle.right self.W: self.paddle.right self.W self.paddle.bottom self.H - PADDLE_BOTTOM_OFFSET if not self.launched: self.ball_x self.paddle.centerx self.ball_y self.paddle.top - self.ball_half return self.ball_x self.speed_x * dt self.ball_y self.speed_y * dt if self.ball_x self.ball_half or self.ball_x self.W - self.ball_half: self.speed_x -self.speed_x self.ball_x max(self.ball_half, min(self.W - self.ball_half, self.ball_x)) if self.ball_y self.ball_half: self.speed_y -self.speed_y self.ball_y self.ball_half if self.speed_y 0: ball_rect pygame.Rect( int(self.ball_x - self.ball_half), int(self.ball_y - self.ball_half), BALL_SIZE, BALL_SIZE, ) if ball_rect.colliderect(self.paddle): self.speed_y -abs(self.speed_y) offset (self.ball_x - self.paddle.centerx) / (self.paddle.width / 2) self.speed_x BALL_BASE_SPEED * self.scale * max(0.5, abs(offset) 0.3) if offset 0: self.speed_x -abs(self.speed_x) elif offset 0: self.speed_x abs(self.speed_x) self.score 1 self.ball_y self.paddle.top - self.ball_half if self.ball_y self.H - self.ball_half: self.lives - 1 if self.lives 0: self.running False else: self.reset_ball() def draw(self): self.screen.fill(BG_COLOR) pygame.draw.rect(self.screen, FG_COLOR, pygame.Rect(0, 0, self.W, self.H), width2) pygame.draw.rect(self.screen, PADDLE_COLOR, self.paddle, border_radius4) pygame.draw.circle( self.screen, BALL_COLOR, (int(self.ball_x), int(self.ball_y)), int(self.ball_half), ) text_surf self.font.render(fScore: {self.score} Lives: {self.lives}, True, TEXT_COLOR) self.screen.blit(text_surf, (10, 6)) if not self.launched: tip_surf self.font_small.render(Click or press Space to launch, True, TEXT_COLOR) self.screen.blit( tip_surf, (self.W // 2 - tip_surf.get_width() // 2, self.H // 2 - tip_surf.get_height() // 2), ) pygame.display.flip() def run(self): while self.running: dt self.clock.tick(60) / 1000.0 dt min(dt, 0.05) for event in pygame.event.get(): if event.type pygame.QUIT: self.running False elif event.type pygame.VIDEORESIZE: self.handle_resize(event.w, event.h) elif event.type pygame.KEYDOWN: if event.key pygame.K_SPACE: self.launch_ball() elif event.key pygame.K_F11: self.toggle_fullscreen() elif event.type pygame.MOUSEBUTTONDOWN: if event.button 1: self.launch_ball() self.update(dt) self.draw() pygame.quit() def parse_args(): parser argparse.ArgumentParser(description壁球小游戏 - 可调整窗口大小) parser.add_argument(--width, typeint, defaultDEFAULT_W, help初始窗口宽度) parser.add_argument(--height, typeint, defaultDEFAULT_H, help初始窗口高度) return parser.parse_args() if __name__ __main__: args parse_args() game Game(args.width, args.height) game.run() sys.exit()3.3 窗口大小变化时代码到底做了什么窗口尺寸变化后游戏绝不能只是“换一块更大的画布”。我把自适应逻辑拆成四个动作对应代码里的四个方法第一重建主 Surface。handle_resize里调用set_mode((new_w, new_h), pygame.RESIZABLE)这是唯一能让窗口真正改变大小的操作。注意new_w和new_h用max(MIN_W, new_w)限制了一下防止用户把窗口缩成一个点导致后续所有除法运算和矩形操作都变得不正常。第二重载字体。pygame.font.Font(None, size)在创建时就确定了字体像素大小窗口变大后如果还沿用旧字体字就会显得小气。_reload_fonts里用self.H // 22计算字号同样限制了下限为 18保证窗口再小也能看清文字。这里的关键是“重载”而不是“缩放”——把一个小字号 Surface 用pygame.transform.scale放大字体会糊边缘全是锯齿效果很差。第三调整速度比例。_apply_scale用当前窗口短边和初始窗口短边的比值计算出一个速度缩放系数。窗口变小球速随之变慢否则小球在很小的窗口里横冲直撞玩家根本反应不过来。窗口变大球速适当变快避免游戏变得过于拖沓。handle_resize里先记下old_scale再计算新scale最后用两者比值修正当前球的实时速度。这样无论在发球前还是发球后拖拽窗口球速都是连续变化的不会出现突然飞走或突然停住。第四约束物体坐标。_clamp_objects把球和球拍限制在窗口边界内。窗口缩小后球原本在窗外这个函数会把球拉回窗内并把它“夹住”在合法范围内。球拍同理如果球拍在缩小后的窗口右侧外面就把它的right拉回self.W。这四个动作一个都不能少。只重建 Surface 不调字体文字大小对不上只调速度不管坐标小球会消失只管坐标不调速度游戏难度和窗口尺寸完全不匹配。3.4 坐标自适应方案对比像素坐标 vs 归一化坐标处理窗口尺寸自适应业界常见的思路有两种。方案 A 是直接使用当前窗口像素坐标这也是上面代码采用的方式。球的位置、球拍的位置都以实际的self.W和self.H为基准窗口变化时重新计算边界并约束位置。优点是逻辑直观调试方便碰撞检测直接对齐显示区域适合壁球这类对象少、规则简单的游戏。方案 B 是游戏逻辑层使用归一化坐标也就是所有位置都存储在 0 到 1 之间的小数绘制时才乘以当前窗口宽高。比如球的位置存储为norm_x 0.5绘制时ball_x norm_x * self.W。这种方案的好处是窗口无论怎么变逻辑层几乎不用改动天然适配任意分辨率。代价是每次绘制都要做一次乘法换算而且碰撞检测、宽度、大小这些参数也要全部归一化理解门槛更高。对于壁球小游戏我个人推荐方案 A。Pygame 的Rect和draw系列函数本身就是基于像素坐标设计的用归一化坐标反而绕弯。等将来你做真正的引擎级项目再考虑方案 B 不迟。4. 常见问题与排查技巧实录4.1 窗口缩小后球“卡”在窗外这是缩放事件最典型的 bug。现象是窗口拖小之后球的一部分或者整个球在可视区域外面玩家看不到球但游戏还在继续球还在跟边界碰撞。原因很简单VIDEORESIZE事件来了之后只更新了self.W和self.H重新创建了 Surface但球的坐标还是之前那么大。窗口缩到比球的横坐标还小球自然就在窗外。解决办法就是在尺寸更新后立刻执行_clamp_objects把所有物体的坐标硬塞回新边界内。调试时可以先在handle_resize里把新尺寸和球的位置一起打印出来马上就能看出坐标有没有越界。4.2 拖动窗口时画面残影、错位表现是窗口拉伸过程中画面像是被涂改过一样部分区域颜色错误物体拖出残影。绝大多数情况下这是因为新 Surface 创建后没有全量重绘。flip()是全量提交但如果你在代码里用了display.update(rect)局部刷新或者其他绘制优化手段窗口尺寸变化时“脏矩形”的预估就会失灵。比如旧画面的某个角落没有重画新窗口扩大后那片区域就残留着上一帧的内容。解决方式很直接每次窗口变化时确保完整走一遍fill背景 绘制所有元素 flip()的流程。拖拽尺寸期间帧率会掉但画面不会坏这就是赢了。4.3 窗口变大后游戏变慢变小后变快如果你在代码里写的是self.ball_x 3这种“每帧固定移动 3 像素”那窗口尺寸变化后游戏速度一定不对。窗口变宽球从一边到另一边需要的帧数变多观察上球变慢了窗口变窄同样的像素增量让球显得更快。解决方法是把速度单位改成“像素/秒”每帧位移是speed * dt。其次窗口尺寸变化后球速还要按当前窗口尺寸与初始尺寸的比例做缩放。这就是_apply_scale的作用。没有这一步你只会得到“速度跟随时间稳定、但在不同窗口尺寸下游戏难度不一致”的结果。4.4 字体变糊或者完全没变Pygame 渲染文字时字体大小在Font对象创建那一刻就固定了。如果你把一个小号字体渲染出来的 Surface 用pygame.transform.scale放大边缘一定糊。还有更隐蔽的情况窗口变化后依然用旧Font对象渲染字号不变小窗口里字显得特别大大窗口里字显得特别小。处理方式是每次handle_resize时基于新窗口高度重新创建Font而不是缩放渲染结果。窗口越大字号越大窗口越小字号跟着变小同时设置下限保证可读性。4.5 常见问题排查速查表现象可能原因解决方案球在窗口缩小后消失缩小时没有约束坐标resize 后调用_clamp_objects拖拽窗口出现残影错位只局部刷新没有全量重绘完整走 fill 绘制 flip窗口大小变化后球速异常速度是像素/帧或者没有缩放比例改用speed * dt并动态调整 scale字体模糊缩放 Surface 而不是重载 Fontresize 时重新创建Font对象全屏切换后画面错乱全屏后没重新设置 W/H 和字体复用 shrink 那套逻辑处理全屏VIDEORESIZE 事件没触发平台差异或事件被吞每帧检查screen.get_size()做兜底第五条值得展开说。全屏切换时set_mode((0, 0), pygame.FULLSCREEN)会让 Pygame 自动选择当前显示器分辨率。你自己以为还是原来的 800x600其实窗口已经变了。所以在toggle_fullscreen里切换完成之后要立刻重新读取self.screen.get_size()再走一遍_reload_fonts和_clamp_objects。很多人在全屏后遇到“画面只占屏幕一半”“球跑到屏幕外”基本都是忽略了这个步骤。5. 扩展方式与实操心得5.1 命令行控制初始窗口大小代码里已经通过argparse支持命令行参数了。实际运行方式python squash.py --width 1024 --height 768这个能力在录制演示视频、或者要在不同设备上演示时非常有用。命令行参数的逻辑并不复杂就是解析--width和--height然后传给Game构造函数。作为游戏开发者把窗口尺寸做成可以命令行注入的输入而不是代码里的魔法常量算是一个非常好的习惯。5.2 全屏切换和 RESIZABLE 的联动全屏模式有一个容易忽略的点从全屏切回窗口模式时最好把窗口尺寸恢复到切全屏之前的值。我代码里在toggle_fullscreen中切回窗口时用的是self.W和self.H。但切全屏时我把self.W和self.H改成了显示器的实际分辨率所以这里要做一点额外处理才不会丢失用户原来的窗口大小。具体做法是在切全屏前备份原始窗口宽高if not self.is_fullscreen: self.windowed_w self.W self.windowed_h self.H self.screen pygame.display.set_mode((0, 0), pygame.FULLSCREEN) else: self.screen pygame.display.set_mode((self.windowed_w, self.windowed_h), pygame.RESIZABLE)上面完整代码里我没有放这个备份是为了让主逻辑更精简。实际项目中强烈建议加上否则用户来回切换几次全屏窗口尺寸会丢失记忆。5.3 做简单的 Model / View 分离壁球游戏现在用一个Game类托管全部逻辑可以运行但如果你打算继续加功能比如双人模式、多球、道具系统建议把“游戏状态计算”和“绘制显示”分开。简单做法是抽出两个模块一个是纯逻辑的Ball类只管坐标、速度、边界检测完全不知道 Pygame 的绘制函数存在另一个是Renderer类负责把Ball的坐标画到屏上。这样做的好处是逻辑层可以直接写单元测试不依赖窗口系统窗口适配的测试成本会大幅降低。等游戏复杂度上来以后你会发现这种拆分带来的收益远大于那一点前期额外代码量。5.4 实操中沉淀的一些经验最后分享几点我自己在项目里反复踩坑后总结的经验。尺寸相关的常量一律从窗口属性读取。写死 800、600 这种数字是新手最容易犯的错一旦窗口可调整这些魔法常量全部要清一遍。浮点位置和 Rect 整数的关系建议“逻辑用浮点、碰撞用 Rect”。球的中心点用 float每帧累加时精度高碰撞检测时临时构造一个pygame.Rect交给colliderect判断。这样既避免了整数取整导致移动卡顿又享受了 Rect 带来的便捷碰撞 API。dt一定要做上限钳制。窗口拖拽、全屏切换的一瞬间帧率可能剧烈波动如果某一帧dt是 0.3 秒球可能直接穿过球拍。dt min(dt, 0.05)这个小操作能避免很多奇葩物理问题。调试窗口事件时先打印再处理。我在写这个项目时发现VIDEORESIZE事件在不同的窗口管理下表现不完全一样有的系统拖拽过程中连续触发几十次有的只触发一次。调试阶段先print(event)把所有事件流看清楚再写对应的处理逻辑能节省大量猜测时间。如果你准备把这个项目继续扩展后续方向其实很多给球增加随机反弹角度、加入道具系统、换成双人对战模式、或者把窗口尺寸适配逻辑抽成通用工具类复用到下一个 Pygame 项目里。窗口大小可控制这件事看起来只是一个细节但它几乎触碰了 Pygame 绘制机制的每一根神经。把这块吃透了再回头写固定尺寸的小游戏你会觉得思路清晰得多。