以下是 Pygame 的詳細使用指南，從安裝到開發完整游戲的步驟說明，包含代碼示例和最佳實踐：

---

一、安裝與環境配置

1. 安裝 Pygame

pip install pygame

2. 驗證安裝

import pygame
pygame.init()
print(pygame.version.ver)  # 應輸出版本號（如 '2.5.2'）

---

二、基礎框架結構

最小化游戲窗口

import pygame# 初始化
pygame.init()
screen = pygame.display.set_mode((800, 600))  # 窗口大小
pygame.display.set_caption("我的游戲")# 游戲主循環
running = True
while running:# 事件處理for event in pygame.event.get():if event.type == pygame.QUIT:running = False# 渲染screen.fill((0, 0, 0))  # 黑色背景pygame.display.flip()    # 更新畫面# 退出
pygame.quit()

---

三、核心功能實現

1. 繪制圖形

# 繪制圖形（在游戲循環內）
pygame.draw.rect(screen, (255, 0, 0), (100, 100, 50, 50))  # 紅色矩形
pygame.draw.circle(screen, (0, 255, 0), (400, 300), 30)     # 綠色圓形

2. 加載圖像

# 加載圖片
player_img = pygame.image.load("player.png").convert_alpha()
# 繪制圖片
screen.blit(player_img, (x, y))

3. 處理鍵盤輸入

keys = pygame.key.get_pressed()
if keys[pygame.K_LEFT]:x -= 5
if keys[pygame.K_RIGHT]:x += 5

4. 碰撞檢測

# 矩形碰撞檢測
player_rect = pygame.Rect(x, y, width, height)
enemy_rect = pygame.Rect(ex, ey, ewidth, eheight)if player_rect.colliderect(enemy_rect):print("碰撞發生！")

---

四、完整游戲案例 - 彈跳小球

import pygame, sys# 初始化
pygame.init()
screen = pygame.display.set_mode((800, 600))
clock = pygame.time.Clock()# 小球屬性
ball_pos = [400, 300]
ball_radius = 20
ball_speed = [5, 5]
ball_color = (255, 255, 255)# 游戲主循環
while True:# 事件處理for event in pygame.event.get():if event.type == pygame.QUIT:pygame.quit()sys.exit()# 更新小球位置ball_pos[0] += ball_speed[0]ball_pos[1] += ball_speed[1]# 邊界檢測if ball_pos[0] <= ball_radius or ball_pos[0] >= 800 - ball_radius:ball_speed[0] *= -1if ball_pos[1] <= ball_radius or ball_pos[1] >= 600 - ball_radius:ball_speed[1] *= -1# 渲染screen.fill((0, 0, 0))  # 清屏pygame.draw.circle(screen, ball_color, ball_pos, ball_radius)pygame.display.flip()    # 更新畫面clock.tick(60)  # 60 FPS

---

五、高級功能實現

1. 精靈（Sprite）系統

class Player(pygame.sprite.Sprite):def __init__(self):super().__init__()self.image = pygame.Surface((50, 50))self.image.fill((0, 255, 0))self.rect = self.image.get_rect()def update(self):keys = pygame.key.get_pressed()if keys[pygame.K_LEFT]: self.rect.x -= 5if keys[pygame.K_RIGHT]: self.rect.x += 5# 使用精靈組
all_sprites = pygame.sprite.Group()
player = Player()
all_sprites.add(player)# 在游戲循環中
all_sprites.update()
all_sprites.draw(screen)

2. 音效播放

# 加載音效
jump_sound = pygame.mixer.Sound("jump.wav")
# 播放音效
jump_sound.play()

3. 字體渲染

font = pygame.font.Font(None, 36)  # 使用系統默認字體
text = font.render("得分: 100", True, (255, 255, 255))
screen.blit(text, (10, 10))

---

六、性能優化技巧

1. 圖像優化：

   # 使用 convert() 加速渲染
   image = pygame.image.load("img.png").convert()
   # 帶透明通道使用 convert_alpha()
   alpha_image = pygame.image.load("img.png").convert_alpha()
   

2. 臟矩形渲染（局部更新）：

   pygame.display.update(rect_list)  # 僅更新指定區域
   

3. 使用精靈組批量繪制：

   group.draw(screen)  # 比單獨繪制每個精靈更高效
   

---

七、發布游戲

1. 打包為可執行文件

使用 PyInstaller：

pip install pyinstaller
pyinstaller --onefile --windowed game.py

2. 創建安裝包

使用 Inno Setup（Windows）或 Briefcase（跨平臺）

---

八、學習資源推薦

1. 官方文檔：pygame.org/docs
2. 免費教程：
   • “Making Games with Python & Pygame”（Al Sweigart）
   • Pygame 官方教程
3. 資源網站：
   • Kenney.nl（免費游戲素材）
   • OpenGameArt.org（開源游戲資源）

---

常見問題解決

1. 畫面閃爍：

   • 使用雙緩沖：screen = pygame.display.set_mode(flags=pygame.DOUBLEBUF)

2. 鍵盤響應延遲：

   • 在事件循環中檢測 KEYDOWN 事件而非 key.get_pressed()

3. 音效不同步：

   • 設置正確的音頻緩沖區大小：

     pygame.mixer.pre_init(44100, -16, 2, 2048)
     pygame.init()
     

---

通過以上步驟，你可以用 Pygame 開發出包括平臺跳躍、射擊游戲、RPG 等類型的 2D 游戲。關鍵開發流程：

1. 初始化 → 2. 主循環 → 3. 事件處理 → 4. 游戲邏輯更新 → 5. 渲染 → 6. 退出清理