運(yùn)一次上下左右控制一個(gè)方塊躲避障礙這樣的小游戲從新手到能跑通的完整過程你會(huì)踩哪些坑、需要懂哪些原理我今天一次性講清楚。1. Pygame到底是什么它不是引擎而是一套媒體工具箱1.1 Pygame的來歷與定位Pygame 是一個(gè)基于 SDL 庫的 Python 第三方庫專門用來處理游戲開發(fā)里最常見的那些事窗口創(chuàng)建、圖像繪制、鍵盤鼠標(biāo)輸入、聲音播放、碰撞檢測(cè)基礎(chǔ)數(shù)據(jù)結(jié)構(gòu)。它最早由 Pete Shinners 在 2000 年左右發(fā)起目的很樸素——讓 Python 程序員不用去折騰底層窗口 API 和圖形接口就能直接做 2D 游戲。這里有一個(gè)很多新手一開始搞不清的點(diǎn)Pygame 不是一個(gè)游戲引擎。你打開 Unity 或者 Godot里面自帶場(chǎng)景、節(jié)點(diǎn)、物理引擎、動(dòng)畫狀態(tài)機(jī)Pygame 不提供這些東西它只給你一堆零件——一個(gè)可以畫圖的窗口、一堆處理輸入的 API、一組幾何結(jié)構(gòu)體。你要做的引擎就是一個(gè) Python 腳本里的循環(huán)。恰恰因?yàn)檫@樣Pygame 特別適合用來理解游戲的核心運(yùn)行機(jī)制游戲 循環(huán) 狀態(tài) 輸入 渲染。1.2 為什么說Pygame是第一款游戲的最佳選擇市面上能用來寫 2D 游戲的 Python 庫不少Arcade、Pyglet、Tkinter 的 Canvas 也能畫圖甚至有人用 Kivy 做小游戲。但我給純新手的建議永遠(yuǎn)是先學(xué) Pygame。原因很簡單資料多。搜Python 游戲開發(fā)十篇文章里有八篇是 Pygame 的遇到問題更容易找到解決方案。門檻低。核心 API 就幾十個(gè)安裝完你就能上手畫第一個(gè)矩形不用理解復(fù)雜的場(chǎng)景樹和組件系統(tǒng)。結(jié)構(gòu)自由度大。正因?yàn)闆]有引擎約束你必須自己設(shè)計(jì)游戲狀態(tài)、自己決定如何組織代碼這反而逼你把基礎(chǔ)打好。1.3 Pygame 2.x相比1.x的最大變化很多人現(xiàn)在搜到老教程還會(huì)遇到pygame.sprite模塊里那些老寫法但要注意 Pygame 2.x 在主循環(huán)、圖像轉(zhuǎn)換、文本渲染上都有明顯改進(jìn)。最大的體感差異有三個(gè)pygame.display.set_mode()不再強(qiáng)制要求立即傳入分辨率可以后續(xù)再動(dòng)態(tài)調(diào)整窗口大小。內(nèi)置了對(duì)高清屏 DPI 縮放的基礎(chǔ)支持雖然仍不完美后面我會(huì)專門說。性能上比 1.x 好了不少Surface.convert()和convert_alpha()的建議依舊有效但普通小游戲里不優(yōu)化也不會(huì)卡。另外要提一嘴pygame-ce社區(qū)版它是原 Pygame 停更維護(hù)后由社區(qū)分叉出來的活躍版本。如果你在 2025 年才開始學(xué)我其實(shí)更推薦直接用pygame-ceAPI 基本兼容修復(fù)了大量老問題安裝名是pygame-ce導(dǎo)入仍然是import pygame。2. 安裝與環(huán)境準(zhǔn)備多花五分鐘就少崩潰一整晚2.1 各平臺(tái)安裝方式與Python版本坑安裝本身不難但很多人的第一個(gè)坑恰恰出在這里。我用的是 Windows直接pip install pygame pygame-ce如果你在 macOS 或 Linux 上流程也差不多。但有幾個(gè)細(xì)節(jié)值得注意盡量不用系統(tǒng)自帶的 Python。macOS 自帶的 Python 是 2.x 時(shí)代遺留的裝了也沒意義Windows 商店版的 Python 有時(shí)路徑有問題pip 裝包倒是可以但后面 PyInstaller 打包時(shí)容易出幺蛾子。建議直接去 python.org 下載官方版本選 3.10 到 3.12 之間的版本都行。檢查 pip 是不是對(duì)應(yīng)版本。同一個(gè)命令行里敲python --version和pip --version確認(rèn)兩者來自同一個(gè)環(huán)境。經(jīng)常有人開了虛擬環(huán)境然后在全局 pip 安裝裝完發(fā)現(xiàn) import 不到。Linux 下可能出現(xiàn)音頻設(shè)備找不到、窗口打不開的問題常規(guī)解決辦法是安裝 SDL 依賴Ubuntu 系一般執(zhí)行sudo apt install libsdl2-2.0-0 libsdl2-mixer-2.0-0 libsdl2-image-2.0-0。裝完驗(yàn)證方式很簡單在終端里跑python -c import pygame; print(pygame.version.ver)如果打印出類似2.6.1的版本號(hào)就說明環(huán)境沒問題。2.2 那個(gè)著名的窗口一閃而過事故這是 Pygame 新手區(qū)提問率最高的問題腳本運(yùn)行了一個(gè)黑色窗口閃了一下馬上消失沒有報(bào)錯(cuò)跑完就退出。本質(zhì)原因特別簡單——你沒有讓程序進(jìn)入持續(xù)循環(huán)。窗口默認(rèn)是畫出后立刻執(zhí)行完腳本就銷毀的想讓窗口停留你必須寫一個(gè)while循環(huán)阻塞住主線程。很多人會(huì)在這里直接抄網(wǎng)上的模板然后疑惑為什么別人代碼能停留。我建議你親手理解一下這個(gè)問題的原理set_mode 創(chuàng)建的窗口生命周期與 Python 進(jìn)程綁定進(jìn)程沒退出窗口就在進(jìn)程一結(jié)束窗口立刻銷毀。你需要在代碼里留一個(gè)循環(huán)結(jié)構(gòu)讓它掛住。后面第三部分我會(huì)專門寫這個(gè)循環(huán)這是整個(gè)游戲開發(fā)最核心的骨架。2.3 給素材文件建一個(gè)干凈的目錄結(jié)構(gòu)這是我做第一個(gè)項(xiàng)目時(shí)沒人告訴我的事。Pygame 項(xiàng)目一開始可以只有一個(gè).py文件但當(dāng)你開始加載圖片、聲音、字體時(shí)散亂的路徑會(huì)讓你后患無窮。最穩(wěn)的項(xiàng)目結(jié)構(gòu)不管以后寫大游戲還是小玩意兒都受用my_game/ ├── main.py ├── settings.py ├── assets/ │ ├── images/ # 圖片素材 │ ├── sounds/ # 音效音頻 │ └── fonts/ # 字體文件 └── modules/ ├── player.py └── enemies.py路徑問題直接關(guān)系到最后打包我放在第 6 部分細(xì)講但目錄結(jié)構(gòu)從第一天就養(yǎng)成習(xí)慣后面省事非常多。3. 核心循環(huán)游戲開發(fā)的第一性原理3.1 主循環(huán)游戲本質(zhì)是一個(gè)無限循環(huán) 條件退出不管多復(fù)雜的游戲剝到最里面都是這樣一個(gè)骨架import pygame pygame.init() screen pygame.display.set_mode((800, 600)) pygame.display.set_caption(我的第一個(gè)游戲) running True while running: # 1. 處理輸入事件 for event in pygame.event.get(): if event.type pygame.QUIT: running False # 2. 更新游戲狀態(tài) # 3. 繪制畫面 screen.fill((0, 0, 0)) pygame.display.flip() pygame.quit()理解這段代碼你就理解了游戲工業(yè)化開發(fā)里常說的游戲循環(huán)。游戲之所以和你平時(shí)寫的那種從上到下跑一遍就結(jié)束的程序不同是因?yàn)樗鼘?duì)實(shí)時(shí)性有要求需要每秒幾十次地重復(fù)做三件事收集輸入用戶按了哪個(gè)鍵、點(diǎn)了哪里、窗口有沒有被關(guān)閉。更新狀態(tài)根據(jù)輸入和游戲規(guī)則去算新位置、新血量、新得分。渲染畫面把最新的狀態(tài)畫到屏幕上。running False是唯一合法的退出方式。這里有一個(gè)常見誤解新手以為要在代碼里寫break來退出游戲?qū)嶋H上對(duì)于while循環(huán)設(shè)置標(biāo)志位讓循環(huán)條件失效然后在while之后統(tǒng)一調(diào)pygame.quit()永遠(yuǎn)是最可控的退出方式。因?yàn)槿绻型局苯?break窗口資源的釋放時(shí)機(jī)就很尷尬容易在退出時(shí)有雜音或窗口殘留。3.2 Surface 與 blit屏幕上的一切都是貼像素我剛學(xué) Pygame 時(shí)最困惑的概念是Surface。后來我把它理解成一張能畫東西的畫布一切瞬間清楚了。窗口是一個(gè) Surface你 load 進(jìn)來的圖片也是一個(gè) Surface甚至一行文字、一個(gè)矩形都會(huì)被 Pygame 渲染成一個(gè)小 Surface。那動(dòng)詞也就是繪制在 Pygame 里叫做blit。它的意思是把一塊 Surface 的像素原樣貼到另一塊 Surface 上。比如我把角色圖片貼到窗口的正中央hero_image pygame.image.load(assets/images/hero.png) screen.blit(hero_image, (400, 300))第二參數(shù)是一個(gè)元組坐標(biāo)代表這張圖片要貼到窗口的哪個(gè)位置。注意那是圖片的左上角位置。一幀一幀地改變這個(gè)坐標(biāo)再重新 blit角色就動(dòng)起來了。這就是動(dòng)畫的全部秘密——不是真的有動(dòng)畫只是快速切換靜幀。Surface上還有一個(gè)常用的方法叫convert_alpha()它的作用是把圖片轉(zhuǎn)換成和窗口一樣的像素格式這樣 blit 時(shí)不用做格式轉(zhuǎn)換速度快很多透明通道也能保留。這是初步優(yōu)化最有效的一行代碼。3.3 Rect 與坐標(biāo)系統(tǒng)左上角原點(diǎn)向下為正Pygame 的坐標(biāo)系和你在數(shù)學(xué)課上學(xué)的不一樣原點(diǎn)在左上角x 軸向右增長y 軸向下增長。也就是說(0, 0)是屏幕左上角(100, 50)是往右 100 像素、往下 50 像素。對(duì)于剛接觸的讀者這個(gè)方向性最容易搞混。一個(gè)簡單記憶法想一想文本在 Word 里是怎么排的電腦屏幕上的坐標(biāo)就是這個(gè)邏輯。Rect是 Pygame 里最實(shí)用的數(shù)據(jù)結(jié)構(gòu)之一。它本質(zhì)是一個(gè)矩形區(qū)域保存了x, y, width, height四個(gè)值同時(shí)提供了大量方便屬性left, right, top, bottom, center, centerx, centery等等。為什么說它實(shí)用因?yàn)橛螒蚶飵缀跛械呐鲎矙z測(cè)、位置判斷都是在和 Rect 打交道。舉個(gè)判斷玩家是否超出屏幕左邊界的例子if player_rect.left 0: player_rect.left 0這樣寫比if player_rect.x 0: player_rect.x 0更直觀因?yàn)閘eft這個(gè)語義本身就是左邊界坐標(biāo)。Rect 還提供move(x, y)方法返回移動(dòng)后的新矩形以及colliderect()方法判斷兩個(gè)矩形是否相交。這些都是后面碰撞檢測(cè)的基礎(chǔ)。3.4 Clock 與 FPS為什么你的游戲一會(huì)快一會(huì)慢新人寫的第一版游戲往往不控制幀率結(jié)果在性能好的電腦上角色飛一樣地跑性能差的電腦上慢吞吞。這是因?yàn)橛螒驙顟B(tài)更新的次數(shù)取決于循環(huán)的迭代速度而在不同機(jī)器上循環(huán)速度并不一樣。解決辦法是給游戲加上Clock節(jié)拍器clock pygame.time.Clock() while running: # ... clock.tick(60)tick(60)的意思是讓這一幀循環(huán)最多持續(xù) 1/60 秒如果這一幀處理得太快就原地等待一下保證每秒最多執(zhí)行 60 次循環(huán)。這樣游戲速度就和硬件無關(guān)了。但這里還有一個(gè)進(jìn)階問題如果你的循環(huán)里某個(gè)操作開銷很大一幀實(shí)際耗時(shí)超過了 1/60 秒那tick(60)并不會(huì)阻止你變慢它只是限速不加速所以性能優(yōu)化永遠(yuǎn)是必要的。等游戲復(fù)雜度上來后你還會(huì)用到增量時(shí)間delta time把角色的移動(dòng)速度寫成每秒 200 像素而不是每幀 5 像素Pygame 2.x 推薦的做法是幀率乘以時(shí)間增量。第一批開發(fā)時(shí)先讓tick(60)控住速度已經(jīng)足夠應(yīng)付絕大多數(shù)小游戲了。4. 事件處理鍵盤、鼠標(biāo)以及那個(gè)事件鎖問題4.1 pygame.event.get() 和 poll() 的差異游戲循環(huán)第一步是處理輸入Pygame 里輸入的表現(xiàn)形式就是事件Event。事件是什么你按一個(gè)鍵、移動(dòng)鼠標(biāo)、點(diǎn)關(guān)閉窗口按鈕操作系統(tǒng)都會(huì)產(chǎn)生一條消息Pygame 把這些消息翻譯成事件對(duì)象塞進(jìn)一個(gè)隊(duì)列里。你得把它們?nèi)〕鰜硖幚?。最常用的取事件函?shù)是for event in pygame.event.get(): if event.type pygame.QUIT: running False它一次取出當(dāng)前隊(duì)列里的所有事件。但我看很多人沒注意過另一個(gè)函數(shù)pygame.event.poll()它的區(qū)別是每次只取一個(gè)事件如果隊(duì)列為空就返回一個(gè)pygame.NOEVENT類型的事件。什么時(shí)候用 poll當(dāng)你不想一次性取空隊(duì)列里所有事件而是想要精確控制每次循環(huán)只處理一個(gè)事件時(shí)可以用 while 循環(huán)包住它。實(shí)踐中大多數(shù)游戲用get()就足夠了但理解 poll 能幫你理清事件隊(duì)列的邏輯get 是把積水一次抽干poll 是一滴一滴接。4.2 鍵盤事件與連續(xù)按鍵兩種思路處理鍵盤輸入有兩種完全不同的思路新手很容易混淆。第一種是事件驅(qū)動(dòng)也就是你按下某個(gè)鍵的瞬間KEYDOWN事件進(jìn)入隊(duì)列松開時(shí)KEYUP事件進(jìn)入隊(duì)列。適用于菜單選擇、跳躍觸發(fā)、打開背包等一次性動(dòng)作。第二種是狀態(tài)查詢用pygame.key.get_pressed()獲取當(dāng)前所有鍵的按下狀態(tài)返回一個(gè)元組索引對(duì)應(yīng)鍵碼。適用于左右移動(dòng)、持續(xù)加速等按住才持續(xù)生效的操作。舉個(gè)例子移動(dòng)角色keys pygame.key.get_pressed() if keys[pygame.K_LEFT]: player_rect.x - 5 if keys[pygame.K_RIGHT]: player_rect.x 5這里有個(gè)很多人踩過的坑如果把左右移動(dòng)也寫在事件驅(qū)動(dòng)的for event循環(huán)里你會(huì)發(fā)現(xiàn)按一下只走一格移動(dòng)手感就像打字機(jī)一樣一頓一頓的。原因就是KEYDOWN只在按下的那一幀產(chǎn)生一個(gè)事件不會(huì)一直發(fā)。所以判斷是否按住必須用get_pressed()判斷按下的一瞬間才用KEYDOWN事件。區(qū)分好這兩個(gè)場(chǎng)景你的手感會(huì)立刻上一個(gè)檔次。4.3 事件鎖到底鎖的是什么熱詞里出現(xiàn)了一個(gè)很有意思的詞——事件鎖。很多人在做游戲時(shí)發(fā)現(xiàn)一個(gè)按鍵按下去程序里同一個(gè)動(dòng)作被觸發(fā)了兩次以上或者游戲狀態(tài)在按下和松開之間極端閃爍。這其實(shí)就是典型的事件競爭問題也就是游戲開發(fā)里需要事件鎖的場(chǎng)景。舉一個(gè)最簡單的例子。你想做一個(gè)按空格暫停的功能if event.type pygame.KEYDOWN and event.key pygame.K_SPACE: paused not paused表面看沒問題但如果某幀里用戶快速按了兩下空格事件隊(duì)列里可能排了兩個(gè)KEYDOWN你的邏輯就會(huì)瞬間執(zhí)行兩次取反結(jié)果暫停等于沒暫停。這種按下動(dòng)作應(yīng)該只生效一次但物理上多觸發(fā)了一次的問題就需要加鎖。兩個(gè)常見的鎖機(jī)制狀態(tài)鎖用幀數(shù)或時(shí)間戳記錄上次觸發(fā)的時(shí)間短時(shí)間內(nèi)不允許再次觸發(fā)。比如last_press_time 200毫秒 之后才允許下一次觸發(fā)防抖。狀態(tài)翻轉(zhuǎn)鎖在KEYDOWN里執(zhí)行取反之后立刻設(shè)一個(gè)space_handled True標(biāo)志直到KEYUP事件出現(xiàn)才把它設(shè)回 False。這樣同一個(gè)按鍵的按住過程中無論KEYDOWN出現(xiàn)多少次只處理第一次。space_handled False for event in pygame.event.get(): if event.type pygame.KEYDOWN and event.key pygame.K_SPACE: if not space_handled: paused not paused space_handled True if event.type pygame.KEYUP and event.key pygame.K_SPACE: space_handled False這就是游戲里事件鎖的直觀解釋。它鎖的不是事件本身而是防止一個(gè)物理動(dòng)作在多幀中產(chǎn)生重復(fù)邏輯。做格斗游戲、射擊游戲時(shí)這類需求會(huì)更多提前理解這個(gè)概念可以省掉不少 debug 時(shí)間。4.4 自定義事件與窗口事件pygame.event.Event()允許你自己制造一個(gè)事件對(duì)象再用pygame.event.post()把它丟回事件隊(duì)列。這個(gè)能力看起來冷門但在做定時(shí)事件比如每 5 秒生成一個(gè)敵人時(shí)非常好用。你可以設(shè)置一個(gè)自定義定時(shí)事件SPAWN_ENEMY pygame.USEREVENT 1 pygame.time.set_timer(SPAWN_ENEMY, 5000) while running: for event in pygame.event.get(): if event.type SPAWN_ENEMY: spawn_enemy()這樣你就能在主循環(huán)里統(tǒng)一處理所有動(dòng)作事件而不用在循環(huán)外掛一堆各自為政的計(jì)時(shí)器了。還有一個(gè)必須處理的窗口事件是pygame.QUIT它對(duì)應(yīng)點(diǎn)擊窗口關(guān)閉按鈕。如果只設(shè)置running False不夠還要記得之后pygame.quit()釋放窗口資源。在復(fù)雜的游戲里你可能還要處理pygame.WINDOWRESIZED事件來重新計(jì)算布局不過基礎(chǔ)階段先不管。5. 從零到一寫一個(gè)能玩的接蘋果小游戲光講 API 不落地等于白講。下面用一個(gè)小游戲把前面所有概念串起來玩家在底部左右移動(dòng)從屏幕頂端不斷掉下蘋果接住得分漏掉則損失一條命。這個(gè)游戲麻雀雖小五臟俱全。5.1 游戲拆解四個(gè)核心部分寫代碼前先拆游戲規(guī)則。任何游戲都可以拆成玩家控制、掉落物、碰撞判定、計(jì)分與結(jié)束條件四個(gè)部分玩家一個(gè)矩形或圖片跟隨鼠標(biāo)或鍵盤左右移動(dòng)。掉落物蘋果圖片或者一個(gè)紅色圓形從頂部以一定速度下落。碰撞判定蘋果與玩家接觸的瞬間得分并移除蘋果。結(jié)束條件某個(gè)蘋果落到底部并超出屏幕范圍時(shí)生命減一生命歸零則游戲結(jié)束。這種先拆規(guī)則再寫代碼的習(xí)慣比寫碼本身更重要。拆得越細(xì)你的代碼結(jié)構(gòu)就越自然。5.2 精靈與組為什么老手一上來就建 ClassPygame 的pygame.sprite.Sprite類和pygame.sprite.Group類是官方推薦的管理游戲?qū)ο蟮姆绞?。Sprite是一個(gè)可繪制、可移動(dòng)、可碰撞的實(shí)體基類Group則是一個(gè)容器可以批量繪制、批量更新、批量檢測(cè)碰撞。import pygame class Apple(pygame.sprite.Sprite): def __init__(self, x, y): super().__init__() self.image pygame.Surface((20, 20)) self.image.fill((255, 0, 0)) self.rect self.image.get_rect(center(x, y)) self.speed 3 def update(self): self.rect.y self.speed if self.rect.top 600: self.kill()這里的self.image和self.rect是 Sprite 的兩個(gè)約定俗成的屬性draw()方法會(huì)依據(jù) rect 位置把 image 畫出來update()方法則是讓每個(gè)精靈執(zhí)行自己的行為邏輯。你只需要在主循環(huán)里調(diào)用apples.draw(screen) apples.update()游戲中所有蘋果的位置更新和繪制就全部完成了。省去了手寫一個(gè)蘋果列表然后逐個(gè)遍歷的麻煩。用面向?qū)ο蟮姆绞絹斫M織游戲?qū)ο笫菐装傩泻箜?xiàng)目還能不被搞亂的關(guān)鍵。雖然用 dict 或 list 也能實(shí)現(xiàn)但類封裝行為、Group 來遍歷可讀性和擴(kuò)展性完全不在一個(gè)層面。5.3 碰撞檢測(cè)矩形碰撞和像素完美碰撞的取舍Pygame 里最樸素的碰撞檢測(cè)是兩個(gè)矩形是否相交對(duì)應(yīng)Rect.colliderect()hits pygame.sprite.spritecollide(player, apples, True) if hits: score 1spritecollide(精靈, 組, True)會(huì)遍歷組內(nèi)所有精靈檢測(cè)與傳入精靈是否碰撞第三個(gè)參數(shù)為 True 表示碰撞到的對(duì)象會(huì)從組里移除。這個(gè)函數(shù)默認(rèn)用的就是矩形碰撞。矩形碰撞的缺點(diǎn)是如果你的物體不規(guī)則比如一個(gè)圓形蘋果被當(dāng)作正方形檢測(cè)四個(gè)角都會(huì)造成看起來沒碰到卻算碰到的假碰撞。解決辦法有兩種用collide_mask參數(shù)指定像素級(jí)碰撞。Pygame 會(huì)按圖像的非透明像素來檢測(cè)精確度最高但性能開銷也大。小游戲里幾十個(gè)物體的像素碰撞沒問題幾百個(gè)就要小心了。手動(dòng)縮小碰撞盒。就是給 Rect 的寬高乘一個(gè)系數(shù)讓判定區(qū)域比畫面區(qū)域小一點(diǎn)。比如 30x30 的圓形圖片碰撞盒設(shè)成 24x24。這招在實(shí)戰(zhàn)中非常常用混合了精確度和性能。我的建議是先全部用矩形碰撞把游戲跑通等確認(rèn)功能穩(wěn)定后再逐個(gè)替換成需要的精確模式。不要一上來就追求完美導(dǎo)致半天調(diào)試不出結(jié)果。5.4 游戲狀態(tài)機(jī)開始界面、游戲中、結(jié)束界面一個(gè)正經(jīng)游戲絕不可能只有一個(gè)永遠(yuǎn)在跑的主循環(huán)。它至少有三個(gè)狀態(tài)開始菜單、游戲進(jìn)行中、結(jié)束畫面。在 Pygame 里沒有現(xiàn)成的場(chǎng)景系統(tǒng)所以你得自己用狀態(tài)變量去控制最常見的寫法是GAME_MENU 0 GAME_PLAY 1 GAME_OVER 2 game_state GAME_MENU while running: if game_state GAME_MENU: # 顯示標(biāo)題和提示文字 # 檢測(cè)按鍵按下空格進(jìn)入游戲 elif game_state GAME_PLAY: # 更新蘋果、檢測(cè)碰撞、更新時(shí)間 # 生命歸零時(shí)切到 GAME_OVER elif game_state GAME_OVER: # 顯示最終得分 # 按任意鍵重新開始這就是一個(gè)極簡的狀態(tài)機(jī)。寫狀態(tài)機(jī)的時(shí)候有個(gè)容易踩的坑不要用if去改狀態(tài)后又同一幀繼續(xù)執(zhí)行新狀態(tài)的邏輯。比如在GAME_MENU分支里檢測(cè)到空格把狀態(tài)改成GAME_PLAY如果下面沒有elif而是連續(xù)if同一幀它會(huì)繼續(xù)跑游戲邏輯導(dǎo)致開局瞬間就產(chǎn)生一次碰撞或更新。所以狀態(tài)分支必須用elif明確互斥或者每個(gè)分支后面continue跳過本輪剩余邏輯。類似地從結(jié)束畫面按下空格重開游戲時(shí)一定要重置所有精靈、分?jǐn)?shù)和時(shí)間否則你會(huì)看到上一局的殘局。狀態(tài)機(jī)是游戲從能跑走向能玩的分水嶺。早期我用一個(gè)超級(jí)大的主循環(huán)堆所有邏輯改個(gè)功能就要滾半天代碼用狀態(tài)機(jī)拆分之后每個(gè)界面的代碼彼此隔離主循環(huán)清爽多了。6. 新手最容易翻車的四個(gè)地方文字、音效、打包和高清屏6.1 中文顯示全變方塊字體加載的坑如果你嘗試在 Pygame 里寫screen.blit(font.render(你好, 游戲, True, (255,255,255)), (100, 100))會(huì)很驚喜地發(fā)現(xiàn)方塊全是方塊。這是 Pygame 新手繞不開的坑。原因在于 Pygame 的默認(rèn)字體不知道去哪加載或者加載到的字體根本不支持中文字符。解決辦法也不是很難你只需要告訴它一個(gè)支持中文的字體路徑。Windows 下可以這樣寫font_path C:/Windows/Fonts/msyh.ttc # 微軟雅黑 font pygame.font.Font(font_path, 36)為了跨平臺(tái)穩(wěn)定更好的做法是把字體文件放進(jìn)項(xiàng)目的assets/fonts/目錄里然后用相對(duì)路徑加載。字體文件一般不能亂拷貝傳播注意看微軟雅黑等字體的版權(quán)但自用學(xué)習(xí)完全沒問題或者可以使用思源黑體等開源字體。還有一個(gè)冷門細(xì)節(jié)pygame.font.SysFont可以通過系統(tǒng)字體名創(chuàng)建字體它在不同系統(tǒng)上字段不同比如 Windows 認(rèn) 微軟雅黑macOS 可能認(rèn) PingFang SC 或 Songti SC因此跨平臺(tái)時(shí)會(huì)出問題。用pygame.font.Font(文件路徑)加載固定字體文件是保證任何機(jī)器上效果一致的最穩(wěn)方案。6.2 音效不響初始化的順序問題如果你的游戲里用了音頻素材必須在任何音頻操作之前調(diào)用pygame.mixer.pre_init()或pygame.mixer.init()。這里大多數(shù)人會(huì)栽的跟頭是在pygame.init()之后再調(diào)用mixer.init有時(shí)會(huì)靜默失敗——播放音效時(shí)沒有聲音也沒報(bào)錯(cuò)。標(biāo)準(zhǔn)做法是提前設(shè)置pygame.mixer.pre_init(44100, -16, 2, 512) pygame.init()這段代碼寫在pygame.init()之前。第二、三、四個(gè)參數(shù)分別是采樣率、位深度、聲道數(shù)、緩沖大小。如果不清楚怎么填默認(rèn)值就夠用重要的是pre_init 必須在 init 前。然后加載音效jump_sound pygame.mixer.Sound(assets/sounds/jump.wav) jump_sound.play()注意play()不是等音頻放完只負(fù)責(zé)啟動(dòng)播放。想做背景音樂用pygame.mixer.music.load(bgm.mp3); pygame.mixer.music.play(-1)-1表示循環(huán)播放。若遇到 MP3 在部分環(huán)境不支持用 WAV 或 OGG 格式最保險(xiǎn)。6.3 PyInstaller 打包路徑機(jī)制的隱藏炸彈游戲?qū)懞煤笙氚l(fā)給朋友玩第一步基本就是pip install pyinstaller然后pyinstaller -F main.py。這一步能跑出 exe 但大概率會(huì)出現(xiàn)一個(gè)大問題游戲啟動(dòng)后找不到圖片、找不到音效。原因不是你的代碼有問題而是 PyInstaller 打出來的程序運(yùn)行時(shí)工作目錄和 Python 環(huán)境不同相對(duì)路徑失效了。解決辦法是寫一個(gè)統(tǒng)一的路徑工具函數(shù)。判斷程序是打包狀態(tài)還是開發(fā)狀態(tài)分別取不同的基準(zhǔn)目錄import sys, os def resource_path(relative_path): base_path getattr(sys, _MEIPASS, os.path.abspath(.)) return os.path.join(base_path, relative_path)在使用素材路徑時(shí)全部通過resource_path(assets/images/hero.png)獲取。這樣開發(fā)時(shí)它返回項(xiàng)目目錄下的路徑打包時(shí)它返回 PyInstaller 釋放臨時(shí)文件的目錄路徑。這個(gè)工具函數(shù)我建議寫進(jìn)所有做 Pygame 項(xiàng)目的人的工具箱真的不知道救了多少次場(chǎng)。另外-F參數(shù)會(huì)把所有東西打成一個(gè)超大文件啟動(dòng)慢殺軟也容易誤報(bào)。如果你發(fā)給別人玩建議用-w隱藏命令行窗口加-F如果只給自己用保留窗口還能方便打印日志。6.4 高清屏和多屏環(huán)境下的坐標(biāo)失真Pygame 2.x 在 Windows 高分屏下的表現(xiàn)依然不完美。如果你的屏幕是 2K、4K 且系統(tǒng)縮放比例調(diào)到 125% 或 150%你會(huì)覺得窗口比設(shè)定的小鼠標(biāo)坐標(biāo)和畫面內(nèi)容對(duì)不上。根本原因是 Windows 在縮放時(shí)系統(tǒng)會(huì)把 Pygame 創(chuàng)建的窗口按邏輯像素顯示但 Pygame 拿到的鼠標(biāo)坐標(biāo)卻是物理像素。一個(gè)簡單粗暴的兼容方案是在代碼開頭讓窗口自適應(yīng)縮放import ctypes ctypes.windll.user32.SetProcessDPIAware()然后再創(chuàng)建窗口。這個(gè) API 調(diào)用在 Windows 上告訴系統(tǒng)我自己處理 DPI不需要你幫我縮放通常能解決大多數(shù)錯(cuò)位問題。但如果你要發(fā)布給各種屏幕配置不同的玩家更穩(wěn)妥的方案是寫分辨率自適配——即固定的游戲邏輯分辨率比如 960x540然后把整個(gè)窗口縮放顯示。這一塊不是新手必須掌握的但如果你準(zhǔn)備把作品發(fā)布給別人玩遲早會(huì)面對(duì)它。第一次遇到坐標(biāo)錯(cuò)位先查 DPI再查是不是窗口真的發(fā)生了 Resize 事件兩個(gè)排查方向基本覆蓋九成問題。最后說幾句心里話如果讓我給后來人一個(gè)最精簡的建議那就是別急著學(xué)很多花哨的功能先把一個(gè)球在屏幕上移動(dòng)、碰撞、計(jì)分、結(jié)束這四件事串起來跑通。這個(gè)過程能讓你真正理解什么是事件循環(huán)、什么是矩形碰撞、什么是狀態(tài)切換。我在實(shí)際開發(fā)中最大的體會(huì)是Pygame 是一個(gè)讓人敢于動(dòng)手的庫——它不完美但它把游戲制作的門檻壓到了一個(gè)下午就可以跨過去的高度。卡住了就去翻事件隊(duì)列、去打印精靈數(shù)量、去查 FPS這些小技巧比任何插件都好用。你的第一個(gè)游戲或許畫面粗糙但親手創(chuàng)造出一個(gè)能運(yùn)行的交互世界那種感覺會(huì)是持續(xù)學(xué)習(xí)的最大動(dòng)力。