Python连连看小游戏源代码解析：从运行到核心逻辑

简介这是一份面向Python初学者与中级开发者的连连看小游戏完整源代码适合想通过实战项目巩固语法、理解GUI编程与游戏逻辑的读者。压缩包共2个文件包含1个py主程序与1个png图片素材整体约84KB轻量易读下载后可直接运行并对照源码学习。项目以Tkinter构建窗口与画布控件通过事件绑定实现点击交互用二维数组表示游戏板布局并借助DFS或BFS完成相同图片的路径匹配判断同时涉及定时器驱动的消除动画、异常捕获与日志记录等实用技巧。代码结构清晰便于在此基础上调整图片数量与布局来改变难度或扩展双人对战等玩法。目前已有5667人学习下载是练习Python基础、图形界面与算法思路的合适参考案例。1. 从一份 Python 连连看小游戏源代码说起它到底能跑出什么很多人第一次搜「Python 连连看小游戏源代码」心里想的其实不是「我要读一份源码」而是「我想在自己电脑上跑出一个能点、能消、能计时的连连看」。这个诉求很朴素但真正落地时会发现一份能跑的连连看源码背后至少压着四件事图形界面怎么画、两张牌能不能连的判定逻辑怎么写、消除之后怎么补位、计时和关卡怎么收尾。把这四件事拆开它就不再是一团黑匣子而是一个可以逐块替换、逐块调试的小工程。这份源码适合两类人一类是刚学完 Python 基础语法想找一个比「猜数字」更有成就感的练手项目另一类是已经会写脚本但没碰过 GUI 和状态管理想借连连看把「界面 逻辑 状态」串一遍。它不解决高并发也不涉及复杂算法但它能让你第一次完整地看到一个小游戏从数据到画面的闭环。下面我按「先跑起来、再拆逻辑、最后调手感」的顺序把这份源代码里真正值得抄的部分讲清楚。2. 把 Python 连连看小游戏源代码跑起来环境、依赖与最小启动命令2.1 选 tkinter 还是 pygame先看你的 Python 安装教程走到哪一步搜「python安装教程」和「python下载安装教程」的人通常卡在第一步装完 Python 之后不知道下一步装什么。连连看这类小游戏常见做法是两条路。第一条是 tkinter它是 Python 标准库自带的装完 Python 就有不需要额外 pip install适合「python入门」阶段只想先看到窗口的人。第二条是 pygame需要单独安装但绘图和事件循环更顺手适合后面想加音效、动画、粒子效果的人。我一般会先看源码里 import 了什么。如果开头是import tkinter as tk那这份源码基本零依赖直接跑。如果是import pygame那就先确认 pip 能用。下面这段命令用来确认环境和安装依赖注意路径和版本号按你自己机器上的来不要照抄别人的绝对路径。# 确认 Python 是否可用以及版本 python --version # 如果源码用 pygame安装依赖 pip install pygame # 进入源码所在目录后启动文件名按实际改 python lianliankan.py逻辑说明第一行只是确认解释器存在避免出现「命令找不到」这种低级翻车。第二行只在源码依赖 pygame 时才需要tkinter 版本跳过。第三行是启动入口很多源码的主文件叫main.py或game.py不要死记文件名先看目录里哪个文件包含if __name__ __main__:。参数说明--version看的是解释器版本建议 3.8 以上太低会遇到 f-string 或类型注解不兼容。pip install后面跟的包名必须和源码 import 的一致pygame 就是 pygame不要写成 pyGame。启动命令里的文件名区分大小写Windows 上不敏感macOS 和 Linux 上写错就报No such file or directory。提示如果你用的是 vscode先按「vscode python环境配置」把解释器选对再在终端里跑上面的命令。解释器选错时pip 装到了另一个 Python 里代码里 import 照样失败这是最常见的「装了却用不了」。2.2 最小可运行结构窗口、画布、事件循环三件套一份能跑的连连看源码不管界面多花骨架都逃不出三件套创建窗口、在窗口上画格子、进入事件循环等待点击。下面这段是 tkinter 版本的最小骨架我把它从完整源码里剥出来方便你先确认「窗口能出来」再往里填逻辑。import tkinter as tk # 1. 创建主窗口 root tk.Tk() root.title(连连看) root.geometry(480x560) # 2. 创建画布所有格子都画在这上面 canvas tk.Canvas(root, width480, height480, bg#f0f0f0) canvas.pack() # 3. 画一个测试格子确认坐标系方向 canvas.create_rectangle(10, 10, 70, 70, fill#4a90d9, outlinewhite) canvas.create_text(40, 40, textA, fillwhite, font(Arial, 20, bold)) # 4. 进入事件循环窗口才会保持显示 root.mainloop()逻辑说明Tk()创建根窗口geometry设定初始大小宽高要和画布匹配否则会出现滚动条或者格子被裁掉。Canvas是连连看的核心控件所有牌面、选中框、连线提示都画在它上面。create_rectangle的四个参数是左上角和右下角坐标tkinter 的 y 轴向下增长和数学坐标系相反第一次写容易把行和列搞反。mainloop()是阻塞调用放在最后它之前的所有绘制才会生效。参数说明width和height决定画布尺寸格子大小乘以行列数不能超过它否则最后一行或一列看不见。bg是背景色选浅灰是为了让彩色牌面更清楚。font里的字号要跟格子大小匹配格子 60 像素时字号 20 左右比较合适太大文字会溢出。fill和outline控制填充色和边框色边框用白色能做出卡片分隔感。注意如果你跑完只看到窗口但里面空白先检查pack()有没有调用再检查绘制语句是不是写在了mainloop()后面。这两个顺序问题占了新手「窗口出不来内容」的一大半。3. 连连看核心判定逻辑两张牌能不能连代码到底在算什么3.1 连通判定的三种路径直线、一个拐角、两个拐角连连看的规则一句话能说完两张相同图案的牌如果能用不超过两个拐角的线连起来且线不穿过其他牌就能消除。但落到代码里这句话要拆成三种情况分别判断。第一种是同行或同列且中间全空直接连。第二种是有一个拐角拐点必须在两张牌构成的矩形另外两个角上且拐点到两张牌的路径都空。第三种是两个拐角需要沿着某一行或某一列扫描找到一条「两段竖直加一段水平」或「两段水平加一段竖直」的通路。下面这段判定函数是这类源码里最值得逐行读的部分我把它写成可独立测试的形式去掉了界面依赖方便你单独跑。def can_link(board, r1, c1, r2, c2): 判断 (r1,c1) 和 (r2,c2) 两张牌能否连通board 中 0 表示空位 if board[r1][c1] ! board[r2][c2] or board[r1][c1] 0: return False # 情况一同行或同列中间全空 if r1 r2 and all(board[r1][c] 0 for c in range(min(c1, c2) 1, max(c1, c2))): return True if c1 c2 and all(board[r][c1] 0 for r in range(min(r1, r2) 1, max(r1, r2))): return True # 情况二一个拐角拐点在 (r1,c2) 或 (r2,c1) if board[r1][c2] 0 and \ all(board[r1][c] 0 for c in range(min(c1, c2) 1, max(c1, c2))) and \ all(board[r][c2] 0 for r in range(min(r1, r2) 1, max(r1, r2))): return True if board[r2][c1] 0 and \ all(board[r][c1] 0 for r in range(min(r1, r2) 1, max(r1, r2))) and \ all(board[r2][c] 0 for c in range(min(c1, c2) 1, max(c1, c2))): return True # 情况三两个拐角沿行或列扫描 for c in range(len(board[0])): if board[r1][c] 0 and board[r2][c] 0 and \ all(board[r1][x] 0 for x in range(min(c1, c) 1, max(c1, c))) and \ all(board[r2][x] 0 for x in range(min(c2, c) 1, max(c2, c))) and \ all(board[r][c] 0 for r in range(min(r1, r2) 1, max(r1, r2))): return True for r in range(len(board)): if board[r][c1] 0 and board[r][c2] 0 and \ all(board[x][c1] 0 for x in range(min(r1, r) 1, max(r1, r))) and \ all(board[x][c2] 0 for x in range(min(r2, r) 1, max(r2, r))) and \ all(board[r][x] 0 for x in range(min(c1, c2) 1, max(c1, c2))): return True return False逻辑说明开头先排除「图案不同」和「点到空位」两种情况这是防御性写法避免后面索引越界或误判。同行同列的判断用all加range注意range的起点要加一、终点不加这样只检查两张牌之间的格子不包含牌本身。一个拐角的判断里拐点必须为空且拐点到两张牌的两条路径都为空两个条件缺一不可。两个拐角的扫描是外层循环找中间行或中间列内层再用all验证三段路径只要找到一条就返回 True。参数说明board是二维列表0表示空位非零表示牌面编号相同编号才能消。r1, c1和r2, c2是两张牌的坐标调用前要保证它们在合法范围内。len(board[0])取列数len(board)取行数行列不要写反。这个函数只做判定不修改board消除操作要另外写这样职责分离调试时可以先单独测判定。提示测试判定逻辑时不要一上来就接界面。先手写几个小board比如 3x3 全空只放两张相同牌用print(can_link(...))看输出。判定对了再接点击事件能省掉大量「点了没反应但不知道哪错了」的时间。3.2 消除、补位与重排状态更新比判定更容易写错判定通过之后真正容易翻车的是状态更新。很多源码在这里出问题消除后没有把board对应位置置零导致下次判定还能连到已经消掉的牌或者补位方向写反牌往上跑还是往下跑和界面显示对不上。常见做法是消除后先置零再决定是「直接留空」还是「整列下移」。留空实现简单下移更像传统连连看但下移会改变坐标所有已记录的选中状态都要清掉。def remove_pair(board, r1, c1, r2, c2): 消除两张牌返回是否成功 if not can_link(board, r1, c1, r2, c2): return False board[r1][c1] 0 board[r2][c2] 0 return True def drop_down(board): 整列下移空位补到顶部适合传统连连看手感 rows, cols len(board), len(board[0]) for c in range(cols): # 从下往上收集非零牌 column [board[r][c] for r in range(rows) if board[r][c] ! 0] # 顶部补零底部放牌 new_col [0] * (rows - len(column)) column for r in range(rows): board[r][c] new_col[r]逻辑说明remove_pair先复用can_link做二次校验避免外部直接调用时绕过规则。置零只改数据不改界面界面刷新由绘制函数统一处理这样数据和显示不会互相干扰。drop_down按列处理先取出该列所有非零牌再在顶部补零最后写回。这样牌会往下落空位留在上方符合多数人对连连看的预期。参数说明rows和cols从board实时取不要写死否则改行列数时容易漏改。new_col的长度必须等于rows否则写回时索引对不上。如果源码选择「留空不补位」那drop_down整个函数可以不要但判定逻辑里对空位的处理要一致不能一半补位一半留空。注意补位之后之前选中的第一张牌的坐标可能已经失效。我一般会在补位后强制清空选中状态宁可让玩家重新点一次也不要出现「选中框停在空位上」这种玄学现象。4. 界面绘制与交互把数据变成能点的格子4.1 用 Canvas 画牌面坐标换算与点击命中数据层用board[r][c]表示界面层要把它画成一个个矩形。这里的关键是坐标换算第 r 行第 c 列的格子左上角 x 是c * cell_sizey 是r * cell_size。点击时反过来用鼠标坐标除以格子大小取整得到行列。这个换算写错就会出现「点 A 消 B」的经典 bug。CELL 60 PADDING 20 def draw_board(canvas, board, selectedNone): canvas.delete(all) for r in range(len(board)): for c in range(len(board[0])): if board[r][c] 0: continue x1 PADDING c * CELL y1 PADDING r * CELL x2 x1 CELL y2 y1 CELL color #ffd166 if selected (r, c) else #4a90d9 canvas.create_rectangle(x1, y1, x2, y2, fillcolor, outlinewhite, width2) canvas.create_text((x1 x2) // 2, (y1 y2) // 2, textstr(board[r][c]), fillwhite, font(Arial, 18, bold)) def on_click(event, board): c (event.x - PADDING) // CELL r (event.y - PADDING) // CELL if 0 r len(board) and 0 c len(board[0]): return r, c return None逻辑说明draw_board每次先delete(all)清空画布再重画这是最省心的刷新方式小游戏规模下性能足够。selected参数用来高亮当前选中的牌颜色区分开玩家才知道自己点了哪张。on_click把鼠标坐标减掉边距再整除格子大小得到行列最后做边界检查防止点到画布外导致索引越界。参数说明CELL是格子边长PADDING是画布四周留白两者要一起调改一个不改另一个会导致点击偏移。width2是边框粗细太粗会吃掉格子内部空间。font字号要小于CELL的三分之一否则数字会贴边。selected用元组比较不要用列表列表不可哈希后面如果放进集合会报错。4.2 计时、关卡与重开小游戏的状态收尾能消之后玩家会问「我消完了会怎样」。一份完整的连连看源码通常有倒计时、关卡递增、重开按钮。倒计时用root.after递归调用不要用time.sleep后者会卡住事件循环窗口直接假死。关卡递增可以简单到「消完当前所有牌就加一层」重开就是把board重新洗牌并重置计时。import random def shuffle_board(rows, cols, kinds8): 生成成对的牌面并打乱 total rows * cols pairs total // 2 values [i % kinds 1 for i in range(pairs)] * 2 random.shuffle(values) return [values[r * cols:(r 1) * cols] for r in range(rows)] def tick(root, label, remain): if remain 0: label.config(text时间到) return label.config(textf剩余 {remain}s) root.after(1000, tick, root, label, remain - 1)逻辑说明shuffle_board先生成成对的编号再整体打乱最后按行切片成二维列表。kinds控制图案种类种类越多越难。tick用after每秒调自己一次remain递减到零就停。这样计时和界面刷新在同一个线程里不会出现跨线程改控件的问题。参数说明rows * cols必须是偶数否则pairs取整后会少一张牌最后剩一张消不掉。kinds不要超过pairs否则有些编号只出现一次永远配不成对。after的第一个参数是毫秒1000 就是 1 秒改小会让倒计时变快调试时可以改成 100 先看流程。提示重开时记得把selected清空、把remain重置、把board重新洗牌三件事少一件都会出现「重开后还能连到上一局的牌」这种后悔药都来不及吃的状态。5. 避坑与排查连连看源代码里最容易翻车的 5 个点5.1 点了没反应但代码没报错现象窗口正常显示点击格子没有任何高亮或消除。原因通常是事件绑定写在了错误的控件上比如绑到了root而不是canvas或者bind的 event 名字写成了Button-1以外的形式。解决确认canvas.bind(Button-1, handler)并且canvas有pack()或grid()没有布局的控件收不到点击。5.2 两张相同的牌明明能连判定却返回 False现象肉眼看着中间没牌但can_link就是 False。原因多半是range边界写错把牌本身也算进了「中间格子」或者行列参数传反。解决在can_link里加一行print(r1, c1, r2, c2, board[r1][c1], board[r2][c2])先确认坐标和牌面值对得上再检查range(min1, max)的写法。5.3 消除后牌面没变但再点原来的位置还能消现象界面看起来牌还在实际数据已经置零再点一次又触发一次消除。原因remove_pair改了board但没有调用draw_board重绘界面和数据不同步。解决每次数据变更后立刻重绘或者用一个统一的refresh()函数包住「改数据 重绘」两步避免漏调。5.4 倒计时越跑越快或者窗口卡死现象计时器一秒跳好几格或者点按钮没反应。原因用了time.sleep放在主线程或者after被重复注册了多次。解决计时只用root.after并且保证同一时间只有一个tick在跑重开时先取消旧的after用root.after_cancel把 id 存下来。5.5 打包或换机器后提示缺少模块现象自己机器上能跑换一台就ModuleNotFoundError。原因源码用了第三方库但没记录依赖或者对方 Python 版本太低。解决在源码目录放一个requirements.txt把pygame之类的写进去对方pip install -r requirements.txt即可。标准库 tkinter 不需要写但要在说明里注明「需要 Python 3.8」。6. 进阶技巧把这份源代码改成你自己的版本跑通之后最有价值的动作不是继续读而是改。我一般会先改三个地方改完基本就能判断这份源码值不值得继续投入。第一把牌面从数字换成 emoji 或图片这一步会逼你理解create_text和create_image的差别也会暴露坐标换算有没有写死。第二把固定行列改成从配置文件读这一步会逼你把所有写死的8和10换成变量顺便清理掉隐藏的魔法数字。第三加一个「提示」按钮自动找一对可连的牌并高亮这一步会逼你把判定逻辑抽成可复用的函数而不是散落在点击事件里。验证改动是否成功不要靠肉眼扫。写一个简单的自测生成一个已知可连的board调用can_link断言为 True再生成一个中间有阻挡的board断言为 False。把这两个断言放在if __name__ __main__:下面每次改完先跑测试再开界面能挡掉大部分回归问题。if __name__ __main__: # 自测同行无阻挡应可连 b1 [[1, 0, 1], [0, 0, 0], [0, 0, 0]] assert can_link(b1, 0, 0, 0, 2) is True # 自测中间有阻挡应不可连 b2 [[1, 2, 1], [0, 0, 0], [0, 0, 0]] assert can_link(b2, 0, 0, 0, 2) is False print(判定逻辑自测通过)参数说明b1和b2都是最小可验证用例行列数小出错时容易定位。断言里的坐标要和board实际尺寸匹配越界会直接抛异常而不是返回 False。print只是给你一个正向反馈真正跑界面时这段可以保留不影响启动。我自己的习惯是任何一份小游戏源代码先跑通、再自测、最后才改界面。顺序反了就会在「界面好看但逻辑不对」的状态里反复翻车。这份连连看源码不大但它把 GUI、状态、判定、计时都串了一遍认真改完一轮比看十篇 python教程 都管用。希望帮到你。本文还有配套的精品资源点击获取