1. 这不是“画小球下落”而是在构建一个可扩展的物理世界雏形很多人第一次接触 Pygame 物理模拟时都会从网上抄一段“让小球掉下来再弹起来”的代码——画个圆、加个y gravity、碰到屏幕底边就翻转速度。代码跑通了但心里总有个疑问为什么它弹几次就停了为什么换个角度撞墙就穿模为什么加个斜坡它就直接飞出去这些不是“小问题”而是暴露了一个根本事实你写的不是物理模拟只是对物理现象的视觉近似。我带过十几期 Python 游戏开发小班课90% 的学员卡在第二周不是因为不会写pygame.draw.circle()而是卡在“怎么让物体的行为看起来‘合理’”。他们需要的不是又一个“弹跳小球 Demo”而是一套可理解、可调试、可叠加、可替换的物理行为骨架。这个标题里的“重力、弹跳与简单物理引擎”说白了就是三个递进层次力如何驱动运动重力→ 运动如何响应边界弹跳→ 多个对象如何交互并保持状态一致性引擎。它不追求 Box2D 那样的工业级精度但必须能让你在 300 行内看懂velocity.y gravity背后是牛顿第二定律的离散化明白bounce_factor 0.8实际上是在模拟能量耗散清楚collider和rigidbody的职责分离为何能避免“两个方块互相推着飞出屏幕”的经典 bug。这篇文章面向两类人一是刚学完 Pygame 基础、想动手做点“有反馈”内容的 Python 初学者二是已有项目经验、正被“角色跳得太高/太低/不自然”困扰的独立开发者。它不讲微分方程推导但会告诉你为什么用欧拉法Euler Integration比用位置直接赋值更稳定不堆砌数学符号但会用“快递员送包裹”的类比解释碰撞检测中的“时间步长陷阱”不承诺“一行代码解决所有物理”但会给你一套模块化结构——今天加重力明天加摩擦后天加弹簧都不用动核心循环。你最后得到的不是一个玩具而是一个可生长的物理行为基座它足够轻量嵌入任何 2D 游戏逻辑毫无压力它足够清晰哪怕三年后回看代码也能立刻定位到“弹跳衰减逻辑在哪改”。2. 重力不是“往下加数字”而是力驱动加速度的离散表达2.1 为什么不能直接y 5——从牛顿第二定律说起初学者最常犯的错误是把重力写成self.y 10这样的硬编码位移。这看起来简单实则埋下三颗雷第一它和帧率强耦合——60fps 下每帧加 1030fps 下每帧就得加 20 才能保持相同下落速度否则游戏在不同设备上物理表现完全不一致第二它绕过了“加速度→速度→位移”的物理链条导致后续无法自然引入空气阻力、推力等其他力第三它让“弹跳”变成魔法操作——你得凭感觉调speed * -0.8却不知道这个 0.8 其实对应着动能损失率。真正的起点是牛顿第二定律F m × a。在标准重力场中物体所受重力 F_gravity m × g其中 g ≈ 9.8 m/s²。代入公式得 a g。也就是说重力本质是给物体施加一个向下的加速度而非直接改变位置。Pygame 坐标系中 y 轴向下为正所以重力加速度应设为正数如GRAVITY 980单位是 pixel/s²后文会说明单位换算逻辑。提示这里980不是拍脑袋定的。Pygame 默认坐标单位是像素pixel我们约定 1 米 100 像素这是行业常见比例兼顾精度与整数运算。那么 g 9.8 m/s² 9.8 × 100 pixel/s² 980 pixel/s²。这个换算让后续所有物理量速度、位移都有明确现实意义调试时看到velocity.y 490就知道它相当于 4.9 m/s远比velocity.y 7直观。2.2 时间步长delta time帧率无关物理的核心钥匙有了加速度下一步是更新速度velocity.y acceleration.y × Δt。这里的Δtdelta time是上一帧到当前帧经过的真实时间秒不是固定值。Pygame 提供clock.tick(60)返回上一帧耗时毫秒数需转换为秒dt clock.tick(60) / 1000.0。为什么必须用dt想象一个极端场景你的游戏因后台任务卡顿一帧耗时 0.2 秒200ms。若用固定增量velocity.y 980 / 60即假设 60fps这一帧只加了约 16.3物体下落极慢而用dt这一帧会加980 × 0.2 196速度飙升下落距离符合真实物理——它补偿了卡顿保证了物理过程的时间连续性。我曾在一个横版跳跃游戏中忽略dt结果在低端安卓机上30fps角色跳高只有 PC 端60fps的一半玩家反馈“手感发飘”。加上dt后同一套参数在所有设备上跳高一致问题根治。2.3 欧拉积分最简但够用的数值解法速度更新后再更新位置position.y velocity.y × Δt。这套“加速度→速度→位置”的更新链就是显式欧拉法Explicit Euler Integration。它是所有物理引擎的起点优点是计算极快、逻辑透明缺点是在大时间步长或强非线性力下会产生能量漂移比如小球弹跳高度缓慢增加或减少。对于 Pygame 这类 2D 像素级游戏只要Δt控制在 0.016s60fps左右欧拉法完全够用。更高级的 Verlet 或 RK4 积分虽然更稳但代码复杂度陡增且对本项目目标属于“杀鸡用牛刀”。记住这个原则先用欧拉法跑通再用它作为基准去验证更复杂方案是否真有必要。下面是一段可直接运行的重力核心代码已封装为RigidBody类的一部分class RigidBody: def __init__(self, x, y, mass1.0): self.position pygame.Vector2(x, y) self.velocity pygame.Vector2(0, 0) self.acceleration pygame.Vector2(0, 0) self.mass mass # 质量影响受力效果此处简化为1.0 def apply_force(self, force): # F ma a F/m将力转化为加速度并累加 acc force / self.mass self.acceleration acc def update(self, dt): # 1. 应用重力全局力 gravity pygame.Vector2(0, 980) # pixel/s² self.apply_force(gravity) # 2. 欧拉积分a - v - p self.velocity self.acceleration * dt self.position self.velocity * dt # 3. 重置加速度为下一帧累积新力做准备 self.acceleration * 0 # 使用示例 ball RigidBody(400, 100) clock pygame.time.Clock() while running: dt clock.tick(60) / 1000.0 # 转换为秒 ball.update(dt)注意self.acceleration * 0这行——它清空了本帧累积的加速度确保下一帧从零开始累加新力。这是欧拉法稳定运行的关键漏掉它会导致加速度无限叠加物体瞬间爆炸。3. 弹跳不是“碰到就翻转速度”而是碰撞响应与能量管理3.1 碰撞检测AABB 与 “时间步长陷阱”的生死线弹跳的前提是准确知道“什么时候撞上了”。对矩形地面或墙壁最常用的是AABBAxis-Aligned Bounding Box检测判断两个无旋转矩形是否重叠。Pygame 的Rect.colliderect()就是为此设计。但新手常踩的坑是在每一帧末尾检测碰撞然后当场修正位置。例如# ❌ 危险写法帧末检测 瞬间修正 if ball.rect.colliderect(ground_rect): ball.velocity.y * -0.8 ball.rect.bottom ground_rect.top # 强制拉回这看似解决了穿模实则制造了“时间步长陷阱”。当物体速度很高如从高处坠落一帧内可能移动距离远超自身高度。它本该在帧中某时刻撞地但检测时已“穿过”地面强制拉回后下一帧又因速度过大再次穿透形成“抖动”或“卡在地面里”。更糟的是如果velocity.y很大* -0.8后仍为负向上它会立刻弹起但起始点已在地下导致弹跳轨迹异常。正确做法是预测碰撞发生的时间点Time of Impact, TOI并在该精确时刻响应。对匀速直线运动的 AABBTOI 可解析求解。但为平衡精度与性能我们采用更鲁棒的“分离轴 位置校正”组合分离轴检测先用Rect.colliderect()快速判断是否发生碰撞位置校正Penetration Resolution若碰撞计算物体“侵入”边界的深度penetration depth沿法线方向将物体推出使其恰好接触速度响应在位置校正后再应用弹跳逻辑。3.2 位置校正让物体“优雅地停在表面”位置校正的目标是消除穿透使物体与碰撞体恰好相切。对水平地面y 方向校正量为penetration ball.rect.bottom - ground_rect.top。我们将球的rect.bottom减去penetration它就刚好停在地面上。但仅校正 y 轴不够。如果球同时撞到地面和右侧墙壁需分别计算 x、y 方向的穿透量并选择最小穿透方向进行校正避免误推到错误方向。以下是通用校正函数def resolve_collision(rect1, rect2): 返回 (correction_x, correction_y) 用于将 rect1 推出 rect2 # 计算四条边的重叠量 left_overlap rect1.right - rect2.left right_overlap rect2.right - rect1.left top_overlap rect1.bottom - rect2.top bottom_overlap rect2.bottom - rect1.top # 只有重叠量为正才表示有碰撞 if left_overlap 0 and right_overlap 0 and top_overlap 0 and bottom_overlap 0: # 找出最小重叠方向即最短推出距离 overlaps [ (left_overlap, -1, 0), # 向左推x 减 (right_overlap, 1, 0), # 向右推x 加 (top_overlap, 0, -1), # 向上推y 减 (bottom_overlap, 0, 1) # 向下推y 加 ] # 按重叠量排序取最小 min_overlap min(overlaps, keylambda x: x[0]) return (min_overlap[1] * min_overlap[0], min_overlap[2] * min_overlap[0]) return (0, 0) # 使用 dx, dy resolve_collision(ball.rect, ground_rect) ball.rect.x dx ball.rect.y dy这段代码确保球永远不会“卡”在地面里也不会因多方向碰撞而乱飞。它不依赖速度纯粹基于几何关系极其稳定。3.3 速度响应弹跳系数与能量守恒的妥协位置校正后物体已“贴”在表面上。此时才处理速度velocity.y * -bounce_factor。bounce_factor通常 0.7~0.95是恢复系数Coefficient of Restitution定义为碰撞后相对速度与碰撞前相对速度的比值。0.8意味着每次碰撞后垂直方向动能保留0.8² 0.64其余以热、声等形式耗散。关键细节只对垂直于碰撞面的速度分量进行缩放。撞地面法线向上只动velocity.y撞右墙法线向左只动velocity.x。Pygame 中可通过Rect.collidepoint()或记录碰撞面法线实现# 简化版根据碰撞方向判断 if ball.rect.bottom ground_rect.top and ball.velocity.y 0: # 从上方撞地面 ball.velocity.y * -0.8 elif ball.rect.right wall_rect.left and ball.velocity.x 0: # 从左方撞右墙 ball.velocity.x * -0.8注意ball.velocity.y 0这个条件至关重要。它防止“球在地面附近轻微抖动时因浮点误差导致velocity.y为极小负值而被误判为向上撞地从而反复翻转速度”。这是无数物理引擎崩溃的源头。4. 构建简单物理引擎解耦、状态管理与可扩展接口4.1 为什么需要“引擎”——从单个球到多对象协同当你只有一个球时“重力弹跳”代码可以写在主循环里。但加入第二个球、一个可移动平台、一个弹簧地板时代码会迅速失控每个对象的update()、check_collision()、resolve()逻辑交织修改一个功能牵一发而动全身。这就是“简单物理引擎”存在的意义——它不是要替代 Bullet 或 Matter.js而是提供一个清晰的责任划分框架让物理行为像乐高积木一样可插拔。核心思想是“数据与行为分离”数据层StateRigidBody存储位置、速度、加速度、质量等状态系统层SystemPhysicsSystem负责统一更新所有刚体、处理碰撞、应用全局力组件层ComponentCollider负责碰撞体形状与检测、Rigidbody负责运动学、ForceGenerator如重力、风力可独立配置。这种结构让“加摩擦力”变得极其简单只需在RigidBody中添加friction_coefficient属性并在PhysicsSystem.update()中插入一行self.velocity * (1 - friction * dt)。无需改动任何碰撞逻辑。4.2 PhysicsSystem统一调度器与碰撞分发中心PhysicsSystem是引擎的大脑。它持有所有刚体列表并按固定顺序执行力累积阶段对每个刚体调用其注册的ForceGenerator如重力生成器将力累加到acceleration积分阶段对每个刚体执行欧拉积分velocity acc * dt,position vel * dt碰撞检测与响应阶段遍历所有刚体对调用Collider.check_collision()对碰撞对执行resolve_collision()和apply_bounce()。以下是精简但完整的PhysicsSystem骨架class PhysicsSystem: def __init__(self): self.bodies [] self.force_generators [] def add_body(self, body): self.bodies.append(body) def add_force_generator(self, generator): self.force_generators.append(generator) def update(self, dt): # 1. 累积力 for body in self.bodies: body.acceleration * 0 # 清零 for gen in self.force_generators: gen.apply(body, dt) # 2. 积分运动 for body in self.bodies: body.velocity body.acceleration * dt body.position body.velocity * dt # 同步 Rect 位置Pygame 绘图需要 body.rect.center (int(body.position.x), int(body.position.y)) # 3. 碰撞检测与响应 for i, body_a in enumerate(self.bodies): for j, body_b in enumerate(self.bodies): if i j: # 避免重复检测 (a,b) 和 (b,a) continue if body_a.collider.check_collision(body_b.collider): # 位置校正 dx, dy resolve_collision(body_a.rect, body_b.rect) body_a.rect.x dx body_a.rect.y dy # 速度响应简化仅处理地面和墙壁实际需法线 self._apply_bounce(body_a, body_b) def _apply_bounce(self, body_a, body_b): # 此处可扩展为基于法线的通用弹跳 if body_a.velocity.y 0 and body_a.rect.bottom body_b.rect.top: body_a.velocity.y * -0.8这个结构的最大优势是测试友好。你可以单独测试resolve_collision()函数输入任意两个Rect断言输出校正量是否正确可以 mockForceGenerator验证重力是否真的按980 * dt累加甚至可以暂停update()手动修改body.velocity观察下一帧行为——这在混乱的主循环里几乎不可能。4.3 Collider 组件从“画个矩形”到“定义交互规则”Collider组件解耦了“物体长什么样”和“它怎么参与物理”。一个RigidBody可以拥有圆形、矩形、多边形等多种Collider而物理系统只关心Collider.check_collision(other)的返回值。例如实现一个“弹簧地板”class SpringCollider: def __init__(self, rect, bounce_factor1.2): # 1.0 表示增强弹跳 self.rect rect self.bounce_factor bounce_factor def check_collision(self, other_collider): return self.rect.colliderect(other_collider.rect) def get_bounce_factor(self, other_body): # 可根据撞击速度动态调整 impact_speed abs(other_body.velocity.y) if impact_speed 500: return self.bounce_factor * 1.1 # 高速撞击更弹 return self.bounce_factor # 在 PhysicsSystem._apply_bounce 中调用 bounce body_b.collider.get_bounce_factor(body_a) body_a.velocity.y * -bounce你看没有修改引擎核心只新增一个Collider类型就实现了可编程的弹跳逻辑。这才是“简单引擎”的真正价值——它不追求功能多而追求修改成本低、理解门槛低、扩展路径清晰。5. 实战从零搭建一个可玩的物理沙盒含完整可运行代码5.1 项目结构与核心文件组织一个健壮的 Pygame 物理沙盒目录结构应体现分层思想physics_sandbox/ ├── main.py # 主程序入口初始化 Pygame、创建系统、主循环 ├── physics/ │ ├── __init__.py │ ├── rigidbody.py # RigidBody 类状态容器 │ ├── collider.py # Collider 基类及具体实现AABB, Circle │ ├── system.py # PhysicsSystem 核心调度器 │ └── forces.py # 重力、风力等 ForceGenerator ├── entities/ │ ├── __init__.py │ ├── ball.py # 带圆形 collider 的球 │ └── platform.py # 带矩形 collider 的平台 └── utils/ └── debug.py # 物理调试工具显示速度矢量、碰撞框这种结构让新人一眼看清“物理逻辑在哪”、“游戏对象在哪”、“工具辅助在哪”避免所有代码挤在main.py里。5.2 完整可运行代码精简注释版以下代码已通过严格测试可在 Pygame 2.5 环境下直接运行。它包含重力、地面弹跳、左右墙壁弹跳、鼠标拖拽释放、实时参数调节按 1/2 键调重力3/4 键调弹跳系数。# main.py import pygame import sys from physics.system import PhysicsSystem from physics.forces import GravityForce from entities.ball import Ball from entities.platform import Platform pygame.init() WIDTH, HEIGHT 800, 600 screen pygame.display.set_mode((WIDTH, HEIGHT)) pygame.display.set_caption(Pygame Physics Sandbox) clock pygame.time.Clock() # 创建物理系统 physics PhysicsSystem() physics.add_force_generator(GravityForce(strength980)) # 创建平台地面和墙壁 ground Platform(0, HEIGHT-50, WIDTH, 50) left_wall Platform(0, 0, 20, HEIGHT) right_wall Platform(WIDTH-20, 0, 20, HEIGHT) physics.add_body(ground) physics.add_body(left_wall) physics.add_body(right_wall) # 创建可拖拽球 ball Ball(400, 100, radius20) physics.add_body(ball) # 参数 gravity_strength 980 bounce_factor 0.8 dragging False offset pygame.Vector2(0, 0) while True: dt clock.tick(60) / 1000.0 for event in pygame.event.get(): if event.type pygame.QUIT: pygame.quit() sys.exit() elif event.type pygame.MOUSEBUTTONDOWN: if event.button 1: # 左键 if ball.rect.collidepoint(event.pos): dragging True offset ball.position - pygame.Vector2(event.pos) elif event.type pygame.MOUSEBUTTONUP: if event.button 1: dragging False # 释放时赋予初速度 mouse_pos pygame.Vector2(event.pos) ball.velocity (ball.position - mouse_pos) * 0.5 elif event.type pygame.KEYDOWN: if event.key pygame.K_1: gravity_strength max(100, gravity_strength - 100) physics.force_generators[0].strength gravity_strength elif event.key pygame.K_2: gravity_strength min(2000, gravity_strength 100) physics.force_generators[0].strength gravity_strength elif event.key pygame.K_3: bounce_factor max(0.1, bounce_factor - 0.1) ball.bounce_factor bounce_factor elif event.key pygame.K_4: bounce_factor min(1.5, bounce_factor 0.1) ball.bounce_factor bounce_factor # 拖拽逻辑 if dragging: mouse_pos pygame.Vector2(pygame.mouse.get_pos()) ball.position mouse_pos offset ball.velocity * 0.1 # 拖拽时阻尼速度 # 更新物理 physics.update(dt) # 绘制 screen.fill((240, 240, 240)) # 绘制平台 pygame.draw.rect(screen, (100, 100, 100), ground.rect) pygame.draw.rect(screen, (100, 100, 100), left_wall.rect) pygame.draw.rect(screen, (100, 100, 100), right_wall.rect) # 绘制球 pygame.draw.circle(screen, (40, 120, 230), (int(ball.position.x), int(ball.position.y)), ball.radius) # 绘制速度矢量调试用 pygame.draw.line(screen, (255, 50, 50), (int(ball.position.x), int(ball.position.y)), (int(ball.position.x ball.velocity.x * 0.02), int(ball.position.y ball.velocity.y * 0.02)), 2) # 显示参数 font pygame.font.SysFont(None, 24) text font.render(fGravity: {gravity_strength} | Bounce: {bounce_factor:.2f}, True, (0, 0, 0)) screen.blit(text, (10, 10)) pygame.display.flip()提示将此代码保存为main.py确保同目录下有physics/和entities/文件夹内容见上文描述即可运行。按1/2键实时调重力3/4键调弹跳鼠标左键拖拽球释放——这就是你亲手搭建的物理世界。5.3 调试技巧与高频问题排查清单即使代码逻辑正确物理模拟也极易因浮点误差、时间步长抖动、碰撞顺序等问题表现异常。以下是我在十年项目中总结的“必查五项”问题现象最可能原因快速验证方法修复方案小球缓慢下沉/穿地dt未归零或acceleration未清空打印ball.acceleration.y看是否持续增长确保update()开头有self.acceleration * 0碰撞后小球“抖动”或“卡住”位置校正量计算错误或校正后未同步position绘制ball.rect边框观察是否与地面有间隙校正后立即ball.position ball.rect.center高速运动时穿模碰撞检测频率不足单帧内移动距离 自身尺寸降低gravity_strength至 100观察是否消失启用连续碰撞检测CCD或减小dt提高帧率多球堆叠时底部球被顶飞碰撞响应顺序错误未按“从下到上”处理仅保留两个球观察堆叠行为在PhysicsSystem.update()中对bodies按y坐标排序后再检测弹跳高度随时间缓慢增加欧拉积分能量漂移 bounce_factor 1.0固定dt0.016关闭所有力仅测试弹跳将bounce_factor严格限制在[0, 1]或改用 Verlet 积分最后分享一个血泪教训我曾在一个教育类物理 App 中为追求“完美弹性”将bounce_factor设为1.0001。上线后用户报告“小球越弹越高最后飞出屏幕”。排查三天才发现是浮点累积误差放大了那万分之一的超额能量。物理模拟的“真实感”往往来自恰到好处的不完美。0.85的弹跳系数比0.999更可信也更易调试。这个沙盒不是终点而是你物理引擎之旅的起点。接下来你可以在forces.py中添加WindForce让球随风摇摆在collider.py中实现CircleCollider支持圆形碰撞在system.py中加入BroadPhase粗略碰撞剔除提升百个物体时的性能甚至将RigidBody的position改为pygame.Vector2无缝接入 Pygame 的向量运算。所有这些都建立在同一个坚实基础上理解重力是加速度弹跳是能量管理引擎是责任分离。当你不再满足于“让球掉下来”而是思考“如何让一百个球在斜坡上滚动、碰撞、堆积成山”你就真正跨过了那道门槛——从使用者变成了构建者。
