本文介绍 Python 轻量级 2D 游戏开发库 Arcade。涵盖环境安装、核心面向对象模型、基础绘图与交互、碰撞检测及完整“太空侵略者”项目实战。通过 Arcade 可快速实现游戏创意，降低开发门槛，适合新手入门。
如果你想入门游戏开发，却被 Unity、Unreal 的复杂界面吓退；如果你熟悉 Python，希望用简洁的代码快速实现游戏创意，那么 Arcade 库会是绝佳选择。Arcade 是一个专为 Python 设计的轻量级 2D 游戏开发框架，它封装了底层图形渲染和用户交互逻辑，让开发者专注于游戏玩法本身，用几十行代码就能实现可玩的小游戏。
本文将从基础用法到完整实战，带你掌握 Arcade 的核心功能，最终打造一款包含碰撞检测、得分系统、关卡切换的迷你游戏，让你轻松踏入游戏开发的大门。
在 Python 游戏开发领域，已有 Pygame、Pyglet 等成熟库，Arcade 的独特优势在于：
如果你是 Python 开发者，想快速验证游戏创意，或教孩子入门编程，Arcade 会比 Pygame 更易上手。
Arcade 支持 Python 3.6+，安装方式简单：
pip install arcade
验证安装是否成功（运行一个简单的窗口）：
import arcade
# 创建窗口（宽度、高度、标题）
arcade.open_window(800, 600, "我的第一个 Arcade 窗口")
# 设置背景色（RGB 值）
arcade.set_background_color(arcade.color.WHITE)
# 开始渲染
arcade.start_render()
# 绘制一个蓝色圆形（中心坐标 x=400, y=300，半径=50）
arcade.draw_circle_filled(400, 300, 50, arcade.color.BLUE)
# 结束渲染并显示
arcade.finish_render()
# 保持窗口打开，直到用户关闭
arcade.run()
运行后会弹出一个白色窗口，中间有一个蓝色圆形，说明安装成功。
Arcade 采用面向对象的游戏循环模型，核心是继承 arcade.Window 类，并重写以下方法：
__init__：初始化窗口、加载资源（图片、声音）、创建游戏对象（玩家、敌人、道具）。setup：重置游戏状态（如分数、生命值、关卡），通常在游戏开始或重启时调用。on_draw：负责绘制游戏画面（玩家、背景、文字等），每帧执行一次。on_update(delta_time)：更新游戏逻辑（移动角色、检测碰撞、判断胜负），每帧执行一次，delta_time为帧间隔时间（用于平滑动画）。on_key_press/on_key_release：处理键盘输入（如上下左右移动）。on_mouse_press等：处理鼠标输入（如点击交互）。这种模型将'绘制'与'逻辑'分离，结构清晰，适合初学者理解。
Arcade 提供了丰富的绘图函数，可快速绘制点、线、矩形、圆形、文本等：
import arcade
class MyGame(arcade.Window):
def __init__(self):
super().__init__(800, 600, "Arcade 绘图示例")
arcade.set_background_color(arcade.color.LIGHT_GRAY)
def on_draw(self):
# 开始绘制
arcade.start_render()
# 绘制矩形（x, y 为左下角坐标，宽，高，颜色）
arcade.draw_rectangle_filled(200, 500, 100, 50, arcade.color.RED)
# 绘制圆形（中心 x, y，半径，颜色）
arcade.draw_circle_outline(400, 500, 30, arcade.color.GREEN, 3)
# 绘制文本（内容，x, y，颜色，字体大小）
arcade.draw_text("Hello Arcade!", 600, 500, arcade.color.BLUE, 18)
# 绘制线段（起点 x1,y1，终点 x2,y2，颜色，线宽）
arcade.draw_line(100, 300, 700, 300, arcade.color.BLACK, 2)
if __name__ == "__main__":
game = MyGame()
arcade.run()
运行后会看到一个包含矩形、圆形、文本和线段的窗口，这些基础图形是构建游戏场景的基石。
通过重写 on_key_press 和 on_update，实现用方向键控制角色移动：
import arcade
class Player:
def __init__(self):
self.x = 400 # 初始 x 坐标
self.y = 50 # 初始 y 坐标
self.speed = 5 # 移动速度
class MyGame(arcade.Window):
def __init__(self):
super().__init__(800, 600, "移动角色示例")
arcade.set_background_color(arcade.color.WHITE)
self.player = Player() # 创建玩家对象
def on_draw(self):
arcade.start_render()
# 绘制玩家（一个黄色正方形）
arcade.draw_rectangle_filled(self.player.x, self.player.y, 40, 40, arcade.color.YELLOW)
def on_key_press(self, key, modifiers):
# 按下方向键时改变速度方向
if key == arcade.key.LEFT:
self.player.x -= self.player.speed
elif key == arcade.key.RIGHT:
self.player.x += self.player.speed
elif key == arcade.key.UP:
self.player.y += self.player.speed
elif key == arcade.key.DOWN:
self.player.y -= self.player.speed
def on_update(self, delta_time):
# 限制玩家在窗口内移动
self.player.x = max(20, min(self.player.x, 780)) # 左右边界（考虑角色宽度 40）
self.player.y = max(20, min(self.player.y, 580)) # 上下边界
if __name__ == "__main__":
game = MyGame()
arcade.run()
运行后，用方向键可控制黄色正方形在窗口内移动，超出边界会被限制——这是所有角色移动逻辑的基础。
Arcade 内置碰撞检测工具，支持矩形、圆形等形状的碰撞判断。以下示例实现'玩家触碰绿色方块得分'：
import arcade
class Player:
def __init__(self):
self.x = 400
self.y = 50
self.size = 40 # 角色大小（用于碰撞检测）
class Target:
def __init__(self):
self.x = 400
self.y = 500
self.size = 30
self.active = True # 是否有效（被触碰后失效）
class MyGame(arcade.Window):
def __init__(self):
super().__init__(800, 600, "碰撞检测示例")
self.player = Player()
self.target = Target()
self.score = 0 # 分数
def on_draw(self):
arcade.start_render()
# 绘制玩家
arcade.draw_rectangle_filled(self.player.x, self.player.y, self.player.size, self.player.size, arcade.color.YELLOW)
# 绘制目标（如果有效）
if self.target.active:
arcade.draw_rectangle_filled(self.target.x, self.target.y, self.target.size, self.target.size, arcade.color.GREEN)
# 绘制分数
arcade.draw_text(f"分数：{self.score}", 10, 10, arcade.color.BLACK, 16)
def on_key_press(self, key, modifiers):
# 移动逻辑（简化版）
speed = 5
if key == arcade.key.LEFT:
self.player.x -= speed
elif key == arcade.key.RIGHT:
self.player.x += speed
elif key == arcade.key.UP:
self.player.y += speed
elif key == arcade.key.DOWN:
self.player.y -= speed
def on_update(self, delta_time):
# 限制玩家移动范围
self.player.x = max(self.player.size//2, min(self.player.x, 800 - self.player.size//2))
self.player.y = max(self.player.size//2, min(self.player.y, 600 - self.player.size//2))
# 检测碰撞（矩形碰撞）
if self.target.active:
# 计算玩家和目标的矩形边界
player_left = self.player.x - self.player.size//2
player_right = self.player.x + self.player.size//2
player_bottom = self.player.y - self.player.size//2
player_top = self.player.y + self.player.size//2
target_left = self.target.x - self.target.size//2
target_right = self.target.x + self.target.size//2
target_bottom = self.target.y - self.target.size//2
target_top = self.target.y + self.target.size//2
# 检测是否碰撞
if (player_right > target_left and player_left < target_right and
player_top > target_bottom and player_bottom < target_top):
self.target.active = False # 目标失效
self.score += 10 # 加分
if __name__ == "__main__":
game = MyGame()
arcade.run()
运行后，控制黄色方块触碰绿色方块，分数会增加，绿色方块消失——这是收集道具、攻击敌人等游戏机制的核心逻辑。
结合上述知识，我们来开发一款经典的'太空侵略者'小游戏，包含以下功能：
import arcade
import random
# 游戏常量
SCREEN_WIDTH = 800
SCREEN_HEIGHT = 600
SCREEN_TITLE = "太空侵略者"
# 角色参数
PLAYER_SPEED = 5
BULLET_SPEED = 7
ENEMY_SPEED = 2
ENEMY_SPAWN_RATE = 0.02 # 每秒生成敌人的概率
class Player(arcade.Sprite):
def __init__(self):
# 用矩形代替飞船（实际项目可用图片）
super().__init__()
self.width = 50
self.height = 30
self.color = arcade.color.BLUE
def update(self):
# 限制玩家在窗口内
self.center_x = max(self.width//2, min(self.center_x, SCREEN_WIDTH - self.width//2))
class Bullet(arcade.Sprite):
def __init__(self, x, y):
super().__init__()
self.width = 5
self.height = 15
self.color = arcade.color.RED
self.center_x = x
self.center_y = y
def update(self):
# 子弹向上移动
self.center_y += BULLET_SPEED
# 超出屏幕顶部则删除
if self.center_y > SCREEN_HEIGHT:
self.remove_from_sprite_lists()
class Enemy(arcade.Sprite):
def __init__(self):
super().__init__()
self.width = 40
self.height = 40
self.color = arcade.color.GREEN
# 随机生成在顶部
self.center_x = random.randint(self.width//2, SCREEN_WIDTH - self.width//2)
self.center_y = SCREEN_HEIGHT - self.height//2
def update(self):
# 敌人向下移动
self.center_y -= ENEMY_SPEED
# 超出屏幕底部则删除
if self.center_y < -self.height//2:
self.remove_from_sprite_lists()
class MyGame(arcade.Window):
def __init__(self):
super().__init__(SCREEN_WIDTH, SCREEN_HEIGHT, SCREEN_TITLE)
arcade.set_background_color(arcade.color.BLACK)
# 创建精灵列表（Arcade 的精灵系统，方便批量处理和碰撞检测）
self.player_list = arcade.SpriteList()
self.bullet_list = arcade.SpriteList()
self.enemy_list = arcade.SpriteList()
# 初始化玩家
self.player = Player()
self.player.center_x = SCREEN_WIDTH // 2
self.player.center_y = 50
self.player_list.append(self.player)
# 游戏状态
self.score = 0
self.lives = 3
self.game_over = False
def on_draw(self):
arcade.start_render()
# 绘制所有精灵
self.player_list.draw()
self.bullet_list.draw()
self.enemy_list.draw()
# 绘制分数和生命值
arcade.draw_text(f"分数：{self.score}", 10, 10, arcade.color.WHITE, 16)
arcade.draw_text(f"生命：{self.lives}", SCREEN_WIDTH - 100, 10, arcade.color.WHITE, 16)
# 游戏结束提示
if self.game_over:
arcade.draw_text("游戏结束！按 R 重启", SCREEN_WIDTH//2 - 200, SCREEN_HEIGHT//2, arcade.color.RED, 30)
def on_key_press(self, key, modifiers):
# 移动玩家
if key == arcade.key.LEFT:
self.player.change_x = -PLAYER_SPEED
elif key == arcade.key.RIGHT:
self.player.change_x = PLAYER_SPEED
# 发射子弹
elif key == arcade.key.SPACE and not self.game_over:
bullet = Bullet(self.player.center_x, self.player.center_y + 20)
self.bullet_list.append(bullet)
# 重启游戏
elif key == arcade.key.R and self.game_over:
self.setup()
def on_key_release(self, key, modifiers):
# 释放方向键时停止移动
if key in (arcade.key.LEFT, arcade.key.RIGHT):
self.player.change_x = 0
def setup(self):
# 重置游戏状态
self.enemy_list.clear()
self.bullet_list.clear()
self.score = 0
self.lives = 3
self.game_over = False
self.player.center_x = SCREEN_WIDTH // 2
def on_update(self, delta_time):
if self.game_over:
return
# 更新所有精灵
self.player_list.update()
self.bullet_list.update()
self.enemy_list.update()
# 随机生成敌人
if random.random() < ENEMY_SPAWN_RATE:
enemy = Enemy()
self.enemy_list.append(enemy)
# 检测子弹与敌人的碰撞
for bullet in self.bullet_list:
# 碰撞检测（利用 Arcade 的内置函数）
hit_enemies = arcade.check_for_collision_with_list(bullet, self.enemy_list)
for enemy in hit_enemies:
enemy.remove_from_sprite_lists()
bullet.remove_from_sprite_lists()
self.score += 10 # 击中加分
# 检测敌人触底（减少生命值）
for enemy in self.enemy_list:
if enemy.center_y < 0:
enemy.remove_from_sprite_lists()
self.lives -= 1
if self.lives <= 0:
self.game_over = True # 生命为 0 时游戏结束
if __name__ == "__main__":
game = MyGame()
arcade.run()
arcade.Sprite 和 SpriteList 管理角色，简化批量更新和绘制；arcade.check_for_collision_with_list 实现碰撞检测；update 方法统一更新游戏逻辑，保证帧率稳定。Arcade 支持加载图片（PNG、JPG）和声音（WAV、MP3），让游戏更生动：
# 加载玩家图片（替换 Player 类的初始化）
class Player(arcade.Sprite):
def __init__(self):
super().__init__("player_ship.png") # 传入图片路径
self.scale = 0.5 # 缩放图片
# 加载射击声音
shoot_sound = arcade.load_sound("laser.wav")
# 播放声音（在发射子弹时）
arcade.play_sound(shoot_sound)
Arcade 内置 PhysicsEngineSimple 物理引擎，支持重力、摩擦力等：
from arcade import PhysicsEngineSimple
# 在 MyGame 的__init__中添加物理引擎
self.physics_engine = PhysicsEngineSimple(self.player, self.wall_list)
# 在 on_update 中更新物理引擎
self.physics_engine.update()
通过管理不同场景的 setup 方法，实现关卡切换：
def setup_level(self, level):
self.enemy_list.clear()
# 根据关卡设置不同的敌人数量和速度
if level == 1:
self.enemy_speed = 2
for _ in range(5):
self.enemy_list.append(Enemy())
elif level == 2:
self.enemy_speed = 3
for _ in range(8):
self.enemy_list.append(Enemy())
Arcade 的核心价值在于降低游戏开发的门槛——无需学习复杂的游戏引擎，用熟悉的 Python 语法就能实现从简单图形到完整游戏的跨越。它的面向对象模型、内置碰撞检测和物理引擎，让开发者能专注于游戏玩法设计，而不是底层技术细节。
本文从基础绘图到完整游戏，展示了 Arcade 的核心功能。如果你有好的游戏创意，不妨用 Arcade 动手实现——从几十行代码的小游戏开始，逐步积累经验，你会发现游戏开发并没有想象中那么难。
现在，打开你的编辑器，用 Arcade 创建属于自己的第一款游戏吧！
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具，curl 转代码在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML转Markdown在线工具，online
通过删除不必要的空白来缩小和压缩JSON。 在线工具，JSON 压缩在线工具，online