Python Pygame五子棋游戏开发：从零实现事件循环与胜负判定

1. 项目概述：从零到一，用Python和Pygame实现你的第一个五子棋游戏

如果你对Python编程感兴趣，并且想找一个既有趣又有挑战性的项目来练手，那么用Pygame库开发一个五子棋小游戏绝对是个绝佳的选择。这不仅仅是一个简单的“Hello World”式的练习，它融合了图形界面编程、事件处理、游戏逻辑判断和简单的数据结构应用，堪称是检验你Python基础是否扎实的“试金石”。我自己在带新人入门时，也常常把这个项目作为从脚本编程迈向应用开发的关键一步。

这个教程的目标非常明确：我们将从零开始，一步步构建一个完整的、可运行的五子棋游戏。它支持双人对战，拥有清晰的棋盘界面、落子动画、胜负判定等核心功能。整个过程，我们将深度依赖Pygame这个强大的2D游戏开发库。Pygame的优势在于它封装了底层的SDL库，让处理窗口、图像、声音和用户输入变得异常简单，即使你之前没有任何游戏开发经验，也能快速上手。通过这个项目，你不仅能学会Pygame的基本使用，更能深刻理解一个游戏程序是如何通过“事件循环”这个核心机制运转起来的。最终，你将得到一个可以和朋友对弈的、完全由你亲手编写的游戏，这种成就感是看多少教程都无法比拟的。

2. 核心思路与架构设计：理解游戏程序的“心跳”

在动手写代码之前，我们必须先想清楚整个游戏的运行逻辑。一个交互式游戏程序，其核心是一个永不停止的“循环”，我们称之为游戏主循环或事件循环。这个循环每秒钟会运行几十甚至上百次，在每一次循环中，它主要做三件事：处理用户的输入（比如鼠标点击）、根据输入更新游戏内部的状态（比如在棋盘数组的某个位置记录一颗黑子）、将最新的游戏状态绘制到屏幕上。理解了这三步，你就抓住了游戏开发的命脉。

对于我们的五子棋游戏，我们可以将整个程序分解为几个相对独立的模块，这样代码结构会更清晰，也便于调试和维护：

1. 游戏初始化模块：负责创建游戏窗口、加载资源（如图片、字体）、初始化游戏状态（如空棋盘、当前执子方）。
2. 棋盘与棋子数据模块：这是游戏的大脑。我们需要一个数据结构（比如一个15x15的二维列表）来精确记录棋盘上每一个交叉点的状态（空、黑子、白子）。所有关于落子、判断胜负的逻辑都围绕这个数据结构展开。
3. 图形绘制模块：负责将抽象的游戏数据（那个二维列表）变成屏幕上可视化的棋盘和棋子。这包括绘制背景、网格线、以及根据数据列表在正确位置绘制黑棋和白棋的图案。
4. 事件处理与游戏逻辑模块：这是游戏的心脏。它监听鼠标点击事件，将鼠标的像素坐标转换为棋盘的网格坐标，然后判断该位置是否可落子。如果可以，就更新数据模块，并触发胜负判断。胜负判断的逻辑是核心算法，需要检查刚落子的位置在横、竖、左斜、右斜四个方向上是否形成了连续的五子。
5. 胜负判定与状态管理模块：专门处理游戏结束的逻辑。一旦检测到五子连珠，就显示获胜信息，并阻止继续落子，直到玩家选择重新开始。

这种模块化的设计思路，使得我们可以分而治之，逐个实现和测试每个部分，最后将它们组装成一个完整的游戏。

3. 环境准备与Pygame基础

3.1 搭建你的Python开发环境

工欲善其事，必先利其器。首先确保你的电脑上安装了Python。我强烈推荐使用Python 3.7或以上的版本。你可以打开命令行（Windows上是CMD或PowerShell，Mac/Linux上是Terminal），输入python --version来检查。如果没有安装，去Python官网下载安装包，安装时务必勾选“Add Python to PATH”这个选项，这能省去后续配置环境变量的麻烦。

接下来是安装Pygame库。Pygame并非Python标准库，所以我们需要用pip这个包管理工具来安装。在命令行中输入以下命令：

pip install pygame

如果下载速度慢，可以考虑使用国内的镜像源，例如清华源：

pip install pygame -i https://pypi.tuna.tsinghua.edu.cn/simple

安装成功后，可以写一个简单的测试脚本来验证：

import pygame pygame.init() print(“Pygame初始化成功！”) screen = pygame.display.set_mode((800, 600)) pygame.display.set_caption(“测试窗口”)

运行这段代码，如果弹出一个800x600的窗口，说明环境配置成功。

注意：有些集成开发环境（IDE）如PyCharm、VSCode可能有自己独立的Python环境。如果你在命令行安装成功但在IDE中导入失败，可能需要检查IDE的Python解释器设置，确保它指向的是你刚刚安装Pygame的那个Python环境。

3.2 Pygame核心概念速览

在深入五子棋开发前，快速理解几个Pygame的核心对象，它们将贯穿我们整个项目：

• pygame.display：显示模块。我们通过它来创建游戏窗口 (set_mode)，更新屏幕内容 (flip或update)。
• pygame.event：事件模块。游戏的所有交互，如键盘按下、鼠标点击、窗口关闭，都通过事件队列来获取。我们的主循环会不断调用pygame.event.get()来获取和处理这些事件。
• Surface对象：你可以把它理解成一张“画布”。我们的屏幕本身是一个大的Surface，棋盘、棋子都是绘制在不同的Surface上，最后再“贴”到主屏幕Surface上。加载的图片也会被转换成Surface对象。
• Rect对象：矩形区域。它用来表示一个对象在屏幕上的位置和大小（x, y, width, height），常用于碰撞检测（比如判断鼠标点击是否在棋盘格内）和图像定位。
• Clock对象：时钟。用于控制游戏的帧率（FPS），确保游戏在不同性能的电脑上都能以基本一致的速度运行，避免循环跑得太快或太慢。

理解了这些，我们就可以开始构建游戏世界的第一块砖——棋盘了。

4. 构建游戏世界：棋盘绘制与数据结构

4.1 初始化游戏窗口与参数定义

一个好的开始是成功的一半。我们先定义一些全局常量，这些数值将决定我们游戏的外观和逻辑。

import pygame import sys # 初始化pygame pygame.init() # 定义颜色 (R, G, B) BACKGROUND = (220, 179, 92) # 棋盘背景色，仿木色 LINE_COLOR = (0, 0, 0) # 网格线颜色，黑色 BLACK = (0, 0, 0) # 黑棋颜色 WHITE = (255, 255, 255) # 白棋颜色 RED = (255, 0, 0) # 用于高亮或提示 # 定义棋盘参数 BOARD_SIZE = 15 # 15x15的标准五子棋盘 GRID_WIDTH = 40 # 每个格子的像素宽度 MARGIN = 50 # 棋盘边距 PIECE_RADIUS = 18 # 棋子半径 # 计算窗口大小 WINDOW_WIDTH = 2 * MARGIN + (BOARD_SIZE - 1) * GRID_WIDTH WINDOW_HEIGHT = WINDOW_WIDTH + 100 # 下方留出空间显示状态信息 # 创建游戏窗口 screen = pygame.display.set_mode((WINDOW_WIDTH, WINDOW_HEIGHT)) pygame.display.set_caption(“Python 五子棋”) clock = pygame.time.Clock()

这里，BOARD_SIZE=15定义了标准的15路棋盘。GRID_WIDTH和MARGIN共同决定了棋盘在窗口中的位置和大小。通过公式计算出窗口尺寸，可以确保棋盘始终居中。

4.2 设计棋盘的数据结构

屏幕上的棋盘是给人看的，程序内部需要一个高效的数据结构来记录棋局状态。一个二维列表是最直观的选择：

# 初始化棋盘状态 # 0: 空， 1: 黑子， 2: 白子 board = [[0 for _ in range(BOARD_SIZE)] for _ in range(BOARD_SIZE)]

这个board列表就是游戏的“内存”。board[row][col] = 1表示在第row行、第col列有一个黑子。所有后续的落子、判断都基于这个列表操作。

4.3 绘制棋盘与棋子

有了数据和参数，我们就可以编写绘制函数了。绘制分为两部分：静态的棋盘网格和动态的棋子。

def draw_board(screen, board): “”“绘制棋盘网格和所有棋子”“” # 1. 填充背景色 screen.fill(BACKGROUND) # 2. 绘制网格线 for i in range(BOARD_SIZE): # 竖线 start_pos = (MARGIN + i * GRID_WIDTH, MARGIN) end_pos = (MARGIN + i * GRID_WIDTH, MARGIN + (BOARD_SIZE - 1) * GRID_WIDTH) pygame.draw.line(screen, LINE_COLOR, start_pos, end_pos, 2) # 横线 start_pos = (MARGIN, MARGIN + i * GRID_WIDTH) end_pos = (MARGIN + (BOARD_SIZE - 1) * GRID_WIDTH, MARGIN + i * GRID_WIDTH) pygame.draw.line(screen, LINE_COLOR, start_pos, end_pos, 2) # 3. 绘制棋盘上的五个小黑点（天元和星位） dots = [(3, 3), (3, 11), (7, 7), (11, 3), (11, 11)] for dot in dots: center_x = MARGIN + dot[0] * GRID_WIDTH center_y = MARGIN + dot[1] * GRID_WIDTH pygame.draw.circle(screen, LINE_COLOR, (center_x, center_y), 5) # 4. 根据board数据绘制棋子 for row in range(BOARD_SIZE): for col in range(BOARD_SIZE): if board[row][col] == 1: # 黑子 center_x = MARGIN + col * GRID_WIDTH center_y = MARGIN + row * GRID_WIDTH pygame.draw.circle(screen, BLACK, (center_x, center_y), PIECE_RADIUS) # 给黑子加一个高光小白点，增加立体感 pygame.draw.circle(screen, (100, 100, 100), (center_x - 4, center_y - 4), 4) elif board[row][col] == 2: # 白子 center_x = MARGIN + col * GRID_WIDTH center_y = MARGIN + row * GRID_WIDTH pygame.draw.circle(screen, WHITE, (center_x, center_y), PIECE_RADIUS) pygame.draw.circle(screen, (200, 200, 200), (center_x - 4, center_y - 4), 4)

这个函数会在每一帧被调用。它先清屏并画上固定的网格和点，然后遍历整个board列表，根据数值在对应坐标绘制棋子。这里我稍微美化了一下，给棋子加了一个小高光，让它们看起来更圆润立体。

实操心得：坐标转换是游戏开发中的高频操作。记住，我们的board列表索引是[行][列]，对应到屏幕坐标是(x, y) = (MARGIN + 列 * GRID_WIDTH, MARGIN + 行 * GRID_WIDTH)。这个公式在鼠标事件处理时也会反向用到，务必理解透彻。

5. 实现游戏交互：落子与胜负判定

5.1 处理鼠标事件与坐标转换

游戏的核心交互是鼠标点击落子。我们需要在事件循环中捕捉鼠标按下事件，并将鼠标的像素坐标转换为棋盘的网格坐标。

def get_board_pos(mouse_x, mouse_y): “”“将鼠标像素坐标转换为棋盘网格坐标 (row, col)”“” # 首先判断点击是否在棋盘区域内 if (mouse_x < MARGIN or mouse_x >= WINDOW_WIDTH - MARGIN or mouse_y < MARGIN or mouse_y >= WINDOW_HEIGHT - 100 - MARGIN): return None, None # 计算最近的交叉点 col = round((mouse_x - MARGIN) / GRID_WIDTH) row = round((mouse_y - MARGIN) / GRID_WIDTH) # 确保坐标在合法范围内 if 0 <= row < BOARD_SIZE and 0 <= col < BOARD_SIZE: return row, col else: return None, None

这里使用了round()函数进行四舍五入，这样玩家点击位置只要离某个交叉点足够近，就会被吸附到该点上，提升了操作体验。WINDOW_HEIGHT - 100是因为我们下方预留了100像素的状态栏区域。

5.2 落子逻辑与轮流下棋

在主循环中，我们处理鼠标事件，并更新游戏状态：

# 游戏状态变量 current_player = 1 # 1 代表黑方， 2 代表白方 game_over = False winner = None # 游戏主循环 running = True while running: for event in pygame.event.get(): if event.type == pygame.QUIT: running = False elif event.type == pygame.MOUSEBUTTONDOWN and not game_over: if event.button == 1: # 左键点击 mouse_x, mouse_y = event.pos row, col = get_board_pos(mouse_x, mouse_y) if row is not None and col is not None and board[row][col] == 0: # 该位置为空，可以落子 board[row][col] = current_player # 检查是否获胜 if check_win(board, row, col, current_player): game_over = True winner = current_player else: # 切换玩家 current_player = 3 - current_player # 巧妙切换1和2

current_player = 3 - current_player是一个小技巧，当当前玩家是1（黑）时，3-1=2（白）；当是2时，3-2=1（黑），实现了轮流下棋。

5.3 胜负判定算法详解

这是五子棋游戏的灵魂。我们需要检查刚落子的位置，在其横、竖、左斜（/）、右斜（\）四个方向上，是否存在连续五个同色棋子。

def check_win(board, row, col, player): “”“检查在(row, col)位置落子后，玩家player是否获胜”“” # 四个方向向量: 横(0,1), 竖(1,0), 左斜(1,1), 右斜(1,-1) directions = [(0, 1), (1, 0), (1, 1), (1, -1)] for d_row, d_col in directions: count = 1 # 刚落下的这颗子 # 向正方向检查 r, c = row + d_row, col + d_col while 0 <= r < BOARD_SIZE and 0 <= c < BOARD_SIZE and board[r][c] == player: count += 1 r += d_row c += d_col # 向反方向检查 r, c = row - d_row, col - d_col while 0 <= r < BOARD_SIZE and 0 <= c < BOARD_SIZE and board[r][c] == player: count += 1 r -= d_row c -= d_col # 如果某个方向连续子数大于等于5，则获胜 if count >= 5: return True return False

这个算法效率很高，它只检查了与最新落子相关的四条线。directions列表定义了四个方向。对于每个方向，我们从落子点开始，向两个相反方向延伸计数，直到遇到边界、空位或异色棋子为止。如果累计数量达到5，则判定获胜。

注意事项：这里判断条件是count >= 5，而不是==5。这是为了程序的健壮性，理论上不会出现大于5的情况（因为落子时会检查位置是否为空），但这样写更安全。另外，这个算法是“无禁手”规则，标准的休闲五子棋。

6. 打磨游戏体验：状态显示、音效与重新开始

6.1 绘制游戏状态信息

为了让玩家清楚当前是谁的回合以及游戏结果，我们需要在屏幕下方绘制状态栏。

def draw_game_info(screen, current_player, game_over, winner): “”“在屏幕下方绘制当前玩家、获胜信息等”“” font = pygame.font.SysFont(None, 36) info_area_y = WINDOW_HEIGHT - 80 if game_over: if winner == 1: text = font.render(“游戏结束！黑方获胜！点击R键重新开始”, True, RED) else: text = font.render(“游戏结束！白方获胜！点击R键重新开始”, True, RED) else: if current_player == 1: text = font.render(“当前回合：黑方”, True, BLACK) else: text = font.render(“当前回合：白方”, True, WHITE) screen.blit(text, (WINDOW_WIDTH // 2 - text.get_width() // 2, info_area_y)) # 绘制简单的操作提示 hint_font = pygame.font.SysFont(None, 24) hint = hint_font.render(“按 R 键重新开始，按 ESC 键退出”, True, (100, 100, 100)) screen.blit(hint, (WINDOW_WIDTH // 2 - hint.get_width() // 2, info_area_y + 40))

这里使用了pygame.font模块来渲染文字。SysFont(None, 36)表示使用系统默认字体，大小为36。blit方法将渲染好的文字Surface绘制到屏幕的指定位置。

6.2 添加音效与落子动画（进阶）

一个带有音效和简单动画的游戏体验会好很多。我们可以为落子添加一个“咔哒”声，并在棋子落下时增加一个由小变大的动画。 首先，准备一个音效文件（如place.wav），放在项目目录下。

# 在初始化部分加载音效 try: place_sound = pygame.mixer.Sound(“place.wav”) except: print(“警告：未找到音效文件，游戏将静音运行。”) place_sound = None # 修改落子逻辑，添加音效和动画标记 animation_pieces = [] # 列表，用于存储正在动画中的棋子信息 (row, col, player, radius) # 在落子成功后 board[row][col] = current_player animation_pieces.append([row, col, current_player, 5]) # 起始半径很小 if place_sound: place_sound.play() # 在主循环的绘制部分之前，更新并绘制动画棋子 for ap in animation_pieces[:]: # 使用切片创建副本进行遍历，因为可能要在循环中删除元素 ap[3] += 1 # 半径增大 if ap[3] >= PIECE_RADIUS: animation_pieces.remove(ap) # 动画结束 else: # 绘制动画中的棋子（半透明，半径逐渐变大） center_x = MARGIN + ap[1] * GRID_WIDTH center_y = MARGIN + ap[0] * GRID_WIDTH color = BLACK if ap[2] == 1 else WHITE # 创建一个临时Surface来绘制带透明度的圆 s = pygame.Surface((PIECE_RADIUS*2, PIECE_RADIUS*2), pygame.SRCALPHA) pygame.draw.circle(s, (*color, 150), (PIECE_RADIUS, PIECE_RADIUS), ap[3]) # 150是透明度 screen.blit(s, (center_x - PIECE_RADIUS, center_y - PIECE_RADIUS))

动画的基本原理是：在落子瞬间，我们不仅更新board数据，还把一个动画信息[row, col, player, radius]加入列表。在主循环中，每帧都增大这个半径并绘制一个半透明的圆，直到半径达到正常棋子大小，再从列表中移除。这样视觉上就形成了一个棋子“长出来”的效果。

6.3 实现重新开始与退出功能

最后，我们完善事件处理，增加重新开始和退出的快捷键。

# 在主循环的事件处理部分补充 for event in pygame.event.get(): if event.type == pygame.QUIT: running = False elif event.type == pygame.KEYDOWN: if event.key == pygame.K_ESCAPE: running = False elif event.key == pygame.K_r: # 按R键重新开始 # 重置所有游戏状态 board = [[0 for _ in range(BOARD_SIZE)] for _ in range(BOARD_SIZE)] current_player = 1 game_over = False winner = None animation_pieces.clear() elif event.type == pygame.MOUSEBUTTONDOWN and not game_over: # ... 原有的落子逻辑 ... # 在主循环中，每帧都需要做的三件事： # 1. 绘制静态棋盘和固定棋子 draw_board(screen, board) # 2. 绘制动画棋子（如果有） # ... (动画绘制代码，如上所述) # 3. 绘制游戏信息 draw_game_info(screen, current_player, game_over, winner) # 4. 更新屏幕 pygame.display.flip() # 5. 控制帧率 clock.tick(60) # 每秒60帧

按R键后，我们将board列表重置为空，并恢复所有游戏状态变量。pygame.display.flip()会将我们这一帧所有绘制的内容更新到屏幕上。clock.tick(60)确保了循环每秒最多运行60次，既保证了动画流畅，又不会过度消耗CPU资源。

7. 项目总结与扩展思考

至此，一个功能完整的双人五子棋游戏就开发完成了。回顾整个过程，我们经历了从环境搭建、Pygame基础学习，到数据结构设计、核心算法实现，再到交互优化和体验打磨的全流程。这个项目虽然不大，但涵盖了小型游戏开发绝大多数核心概念：事件驱动、状态管理、图形绘制、碰撞检测（坐标转换）、胜负逻辑算法。

我个人在多次实现和教学这个项目后，最大的体会是：清晰的模块划分和数据结构设计是代码可读性和可维护性的基石。一开始就把board这个二维列表定义好，后续的所有功能都围绕着它展开，思路会非常清晰。另一个关键是理解并熟练运用“事件循环”模型，这是所有交互式图形程序的通用范式。

这个项目还有巨大的扩展空间，你可以尝试挑战以下功能，让游戏变得更强大：

1. 实现人机对战：这是最经典的扩展。你可以从最简单的随机落子AI开始，然后实现基于“棋型”评估的规则AI（比如优先堵对方活四、冲四，自己创造活三等），这需要你设计一个评估函数来给棋盘上的每个空位打分。
2. 增加游戏模式：比如选择棋盘大小（13路、19路）、设置禁手规则（针对黑棋的“三三禁手”、“四四禁手”、“长连禁手”），这会让胜负判定逻辑变得复杂但更有挑战性。
3. 美化界面：使用真实的木质棋盘和玉石棋子图片替代简单的几何图形绘制。为不同状态添加更丰富的音效（如开始音效、获胜音效）。甚至可以加入背景音乐。
4. 网络对战：使用Socket编程，将游戏改造成一个客户端-服务器架构，支持两个人在不同的电脑上联机对战。这会将项目从一个单机程序升级为一个真正的网络应用。

把基础版本跑通后，选择其中一个方向深入下去，你收获的将不仅仅是一个五子棋游戏，更是解决复杂问题、架构软件系统的宝贵经验。编程的乐趣，正是在于将想法一步步变为现实，并不断打磨完善的过程。希望这个教程能成为你游戏开发之路上一块坚实的垫脚石。