简介这是一份面向Python初学者与入门级开发者的连连看小游戏实战项目源码聚焦GUI编程与游戏逻辑实现帮助学习者通过完整可运行案例掌握Tkinter界面开发、二维数组状态管理、DFS路径匹配算法及事件驱动交互设计。资源包含2个核心文件1个PNG图片素材用于游戏图标和1个main.py主程序含完整注释与模块化函数压缩包仅84KB轻量易部署适合快速运行调试与代码拆解学习。已有5667人下载学习读者可直接复现经典连连看玩法深入理解变量控制、条件判断、定时器动画更新及异常处理等关键知识点并基于现有结构拓展难度调节、计分系统或音效支持。1. 为什么用 Python 写连连看不是“玩具项目”而是练透 GUI、事件驱动和状态管理的硬核入口你在网上搜“Python连连看小游戏源代码”大概率是想快速跑起来一个能点、能连、能清空的界面——但真正卡住你的从来不是“怎么画两个方块”而是点击后坐标没对上明明鼠标在格子上却选中了隔壁连线逻辑写了一堆 if-else第三步就绕晕删掉重写四次换个分辨率窗口就错位图标糊成一团连“重置”按钮都点不着本地跑通了发给同事却报ModuleNotFoundError: No module named PIL——而你根本没意识到 Pillow 是隐式依赖。这不是小项目是GUI 工程能力的压缩包它强制你面对真实桌面交互的全部毛刺——坐标系转换、双击防抖、路径缓存、资源加载时序、状态同步、重绘边界控制。我带新人做项目前常让他们用纯 tkinter PIL 实现一版可玩的连连看不许用 PyGame3 天内必须交出支持 8×8 到 12×12 动态棋盘、任意两点间最多三段折线连通、失败时高亮阻塞点、计时步数统计撤销栈。不是为了做出游戏而是逼他们亲手把“事件循环”从概念抠成肌肉记忆。本文不讲“Python 入门语法”不贴“50 行极简版”——那种代码连图片加载都靠tk.PhotoImage(file...)硬塞一换路径就崩。我们从零构建一个可维护、可调试、可扩展、能打包成独立 exe 的生产级最小闭环用 tkinter 做主框架轻量、免依赖、Windows/macOS/Linux 原生兼容PIL 处理图像缩放与裁切解决高清屏适配自研路径查找器非 DFS 爆搜而是带转向惩罚的 A* 变体所有状态集中管理无全局变量全靠self.state和self.emit()。源码结构清晰到能直接塞进公司内部工具链——这才是你搜“Python连连看源代码”真正该拿到的东西。2. 从零搭起可运行骨架tkinter 主循环 图片资源预加载 棋盘坐标映射2.1 创建带 DPI 感知的主窗口解决高清屏文字/图标模糊问题很多“源码”直接Tk()启动结果在 2K 屏上按钮小得像蚂蚁文字发虚。根本原因是 tkinter 默认不启用系统 DPI 缩放。必须在Tk()实例化前插入 Windows/macOS 特定适配import sys import tkinter as tk from tkinter import ttk, messagebox # --- DPI 适配前置Windows 必加macOS 可选--- if sys.platform win32: try: from ctypes import windll windll.shcore.SetProcessDpiAwareness(1) # 1: 系统 DPI 感知2: 每显示器 DPI 感知 except (ImportError, AttributeError): pass # 老系统忽略 root tk.Tk() root.title(Python 连连看) root.geometry(800x600) # 初始尺寸后续动态调整 root.minsize(640, 480) # --- 强制启用 tkinter 的缩放支持 --- root.tk.call(tk, scaling, 1.25) # 1.25 125% 缩放匹配常见 125% DPI 设置提示tk.call(tk, scaling, X)是 tkinter 官方推荐的 DPI 缩放方式比root.option_add(*Font, Arial 10)更底层、更稳定。数值1.25对应 Windows 显示设置中的“放大到 125%”若用户设为 150%此处应改为1.5。实际项目中建议读取系统 DPI 值动态计算见 4.3 节。2.2 预加载图片资源并统一管理避免运行时卡顿与路径错误连连看核心是图片格子但直接PhotoImage(filea.png)有两大坑文件路径相对当前工作目录打包成 exe 后路径失效每次点击重新加载图片频繁 IO 导致 UI 卡顿。正确做法启动时一次性加载所有图片转为tk.PhotoImage并缓存后续只复用对象。同时用getattr(sys, _MEIPASS, .)兼容 PyInstaller 打包路径from PIL import Image, ImageTk import os import sys class ResourceManager: def __init__(self): self.images {} # {name: PhotoImage} self.base_path getattr(sys, _MEIPASS, os.path.dirname(os.path.abspath(__file__))) def load_image(self, name, width60, height60, resize_methodImage.LANCZOS): 安全加载并缓存图片支持打包后路径 if name in self.images: return self.images[name] # 构建绝对路径assets/icons/xxx.png img_path os.path.join(self.base_path, assets, icons, f{name}.png) if not os.path.exists(img_path): # fallback用纯色占位图避免崩溃 img Image.new(RGB, (width, height), #cccccc) else: try: img Image.open(img_path) except Exception as e: print(f[WARN] 图片加载失败 {img_path}: {e}) img Image.new(RGB, (width, height), #ff9999) # 统一缩放到指定尺寸关键不同分辨率设备需一致 img img.resize((width, height), resize_method) tk_img ImageTk.PhotoImage(img) self.images[name] tk_img return tk_img # 初始化资源管理器全局单例 res_mgr ResourceManager()参数说明width/height强制统一格子尺寸避免因原始图大小不一导致布局错乱resize_methodImage.LANCZOS高质量缩放算法比Image.NEAREST清晰比Image.BILINEAR锐利适合图标类小图getattr(sys, _MEIPASS, ...)PyInstaller 打包后会将资源解压到临时_MEIPASS目录此写法自动适配开发态与打包态。2.3 棋盘坐标映射把像素坐标精准转为逻辑格子索引连连看本质是二维数组操作但用户点击的是屏幕像素。常见错误是直接(x//cell_w, y//cell_h)整除——这在窗口缩放、边框偏移、滚动条存在时必然错位。必须用精确几何映射class GameBoard: def __init__(self, root, rows8, cols8, cell_size60, padding20): self.rows rows self.cols cols self.cell_size cell_size self.padding padding # 计算棋盘可视区域扣除边距 self.board_width cols * cell_size self.board_height rows * cell_size self.x0 padding # 左边距 self.y0 padding # 上边距 self.x1 self.x0 self.board_width # 右边界 self.y1 self.y0 self.board_height # 下边界 def pixel_to_grid(self, x, y): 将鼠标像素坐标转为 (row, col)严格限定在棋盘区域内 if not (self.x0 x self.x1 and self.y0 y self.y1): return None # 点击在棋盘外 # 减去边距再整除格子尺寸注意浮点转 int 截断非四舍五入 col int((x - self.x0) // self.cell_size) row int((y - self.y0) // self.cell_size) # 边界校验防止因浮点误差越界 if 0 row self.rows and 0 col self.cols: return (row, col) return None def grid_to_pixel(self, row, col): 将逻辑坐标转为左上角像素位置用于绘制 x self.x0 col * self.cell_size y self.y0 row * self.cell_size return (x, y) # 实例化棋盘放在主窗口创建后 board GameBoard(root, rows10, cols10, cell_size56, padding30)关键设计点pixel_to_grid返回None而非默认(0,0)强制调用方处理“点击无效”场景grid_to_pixel只返回左上角绘制时由调用方决定是否加cell_size绘制整个格子所有尺寸计算基于cell_size和padding后续调整分辨率只需改这两个参数无需动坐标逻辑。3. 核心玩法实现可撤销的双选机制 三折线连通判定 状态驱动重绘3.1 双选状态机用有限状态管理点击流杜绝误操作连连看最易翻车的交互是点第一个图标手滑点错第二个结果清空了不该清的。必须用显式状态机隔离选择阶段class GameState: def __init__(self, rows, cols): self.rows rows self.cols cols self.grid [[None for _ in range(cols)] for _ in range(rows)] # 存 icon name self.selected [] # [(r1,c1), (r2,c2)]长度 0/1/2 self.history [] # 用于撤销[(r1,c1,r2,c2, old_icon1, old_icon2), ...] self.step_count 0 self.time_elapsed 0 def select_cell(self, row, col): 处理单次点击状态流转 业务逻辑 if not (0 row self.rows and 0 col self.cols): return False icon self.grid[row][col] if icon is None: # 空格子不可选 return False if len(self.selected) 0: # 第一次点击记录位置 self.selected [(row, col)] return True elif len(self.selected) 1: r1, c1 self.selected[0] if (r1, c1) (row, col): # 点击同一格取消选择 self.selected [] return True elif icon self.grid[r1][c1]: # 图标相同尝试连接 if self.can_connect(r1, c1, row, col): # 执行消除 self._remove_pair(r1, c1, row, col) self.step_count 1 self.selected [] return True else: # 不能连保留第一次选择等待新点击 self.selected [(row, col)] return True else: # 图标不同切换选择目标 self.selected [(row, col)] return True return False # 选满两格后不再响应点击 def _remove_pair(self, r1, c1, r2, c2): 执行消除存历史、清空格子、触发重绘 self.history.append((r1, c1, r2, c2, self.grid[r1][c1], self.grid[r2][c2])) self.grid[r1][c1] None self.grid[r2][c2] None状态流转逻辑selected[]→ 点击任意有效格 →selected[(r,c)]selected[(r1,c1)]→ 点击同格 →selected[]取消selected[(r1,c1)]→ 点击异格且图标相同 → 尝试连接 → 成功则清空两格失败则selected[(r2,c2)]selected[(r1,c1)]→ 点击异格且图标不同 →selected[(r2,c2)]切换目标。没有“第三次点击”状态彻底规避多点误触。3.2 三折线连通判定A* 路径搜索 转向惩罚比 BFS 更符合人眼直觉“能连”不是简单判断直线或 L 形而是允许最多两个直角转折即三段线水平→垂直→水平。暴力 BFS 会遍历大量无效路径。我们采用带转向代价的 A* 搜索启发函数用曼哈顿距离转向动作额外加10代价import heapq from typing import List, Tuple, Optional def can_connect(grid, start: Tuple[int,int], end: Tuple[int,int], max_turns2) - bool: 判断两点能否用 ≤ max_turns 个直角转折连通即 ≤ max_turns1 段线 grid: 二维列表None 表示空路径其他值表示障碍物 if start end: return True rows, cols len(grid), len(grid[0]) sr, sc start er, ec end # 方向向量上、右、下、左 dirs [(-1,0), (0,1), (1,0), (0,-1)] # 状态(cost, r, c, last_dir, turns) # last_dir: -1未移动, 0~3方向索引turns已转向次数 pq [(0, sr, sc, -1, 0)] visited {} # (r,c,last_dir,turns) - min_cost while pq: cost, r, c, last_d, turns heapq.heappop(pq) # 到达终点 if (r, c) end: return True # 剪枝转向超限或已访问更优路径 state (r, c, last_d, turns) if state in visited and visited[state] cost: continue visited[state] cost # 尝试四个方向移动 for d, (dr, dc) in enumerate(dirs): nr, nc r dr, c dc if not (0 nr rows and 0 nc cols): continue if grid[nr][nc] is not None: # 障碍物 continue # 计算新转向次数 new_turns turns if last_d ! -1 and last_d ! d: new_turns 1 if new_turns max_turns: continue # 移动代价基础 1 转向惩罚 10 move_cost 1 (10 if new_turns turns else 0) new_cost cost move_cost # 启发曼哈顿距离 h abs(nr - er) abs(nc - ec) heapq.heappush(pq, (new_cost h, nr, nc, d, new_turns)) return False为什么不用简单 L 形检测简单 L 形如(r1,c1)-(r1,c2)-(r2,c2)漏掉 Z 形、U 形等合法路径纯 BFS 不区分转向会优先选“蛇形”路径视觉上不自然A* 转向惩罚让算法倾向选择“直→折→直”这种人眼认为“干净”的路径体验更佳。3.3 状态驱动重绘只更新变化区域避免全屏闪烁tkinter 的canvas.delete(all)全清重绘在复杂界面下肉眼可见闪烁。正确做法是按需局部刷新class GameCanvas: def __init__(self, parent, board: GameBoard, state: GameState): self.canvas tk.Canvas(parent, bg#f0f0f0, highlightthickness0) self.board board self.state state self.items {} # {(r,c): canvas_id}缓存所有格子图形ID # 绑定事件 self.canvas.bind(Button-1, self.on_click) self.canvas.pack(fillboth, expandTrue) def on_click(self, event): grid_pos self.board.pixel_to_grid(event.x, event.y) if grid_pos: r, c grid_pos if self.state.select_cell(r, c): self.redraw_cell(r, c) # 仅重绘被点击格子 if len(self.state.selected) 2: r1,c1,r2,c2 *self.state.selected[0], *self.state.selected[1] self.redraw_cell(r1, c1) self.redraw_cell(r2, c2) # 若消除成功重绘周边受影响格子下落动画前 self._redraw_falling_area(r1, c1, r2, c2) def redraw_cell(self, r, c): 重绘单个格子清除旧图绘制新图 if (r, c) in self.items: self.canvas.delete(self.items[(r, c)]) del self.items[(r, c)] icon_name self.state.grid[r][c] if icon_name is None: return # 空格子不画 x, y self.board.grid_to_pixel(r, c) # 使用预加载的图片 tk_img res_mgr.load_image(icon_name, widthself.board.cell_size, heightself.board.cell_size) item_id self.canvas.create_image(x, y, anchornw, imagetk_img) self.items[(r, c)] item_id # 关键绑定图片对象防止被垃圾回收 self.canvas.image_refs getattr(self.canvas, image_refs, []) [tk_img]核心技巧self.items缓存每个格子的 canvas ID重绘时先delete再create而非覆盖self.canvas.image_refs保存对PhotoImage的强引用否则 tkinter 会回收图片导致显示空白经典玄学坑anchornw确保图片左上角对齐像素坐标避免居中偏移。4. 避坑指南那些让“源码跑不起来”的真实血泪现场4.1 现象打包成 exe 后图片全变成灰色方块原因PyInstaller 默认不打包assets/目录res_mgr.load_image()中的os.path.join(..., assets, ...)路径在_MEIPASS里不存在。解决在pyinstaller命令中显式添加资源目录pyinstaller --add-data assets;assets --onefile game.py或在代码中增强 fallback 逻辑见 2.2 节但必须保证 assets 目录结构与代码中os.path.join路径完全一致。4.2 现象高分屏如 MacBook Retina上格子严重错位点击位置和实际格子偏差 2 倍原因macOS 的 tkinter 默认使用逻辑像素logical pixels而grid_to_pixel计算用的是物理像素physical pixels未乘以root.winfo_screenmmwidth() / root.winfo_screenwidth()换算系数。解决# 在 GameBoard.__init__ 中动态获取缩放因子 if sys.platform darwin: # macOS try: # 获取系统缩放比例1.0100%, 2.0200% import subprocess result subprocess.run( [defaults, read, -g, AppleDisplayScaleFactor], capture_outputTrue, textTrue ) scale float(result.stdout.strip()) if result.returncode 0 else 2.0 self.cell_size int(cell_size * scale) self.padding int(padding * scale) except: self.cell_size cell_size * 2 self.padding padding * 24.3 现象连续快速点击时select_cell()有时不响应或selected状态混乱原因tkinter 事件队列中多个Button-1事件堆积state.select_cell()被并发调用而self.selected是普通 list非线程安全。解决根本方案在on_click中加事件节流debouncedef on_click(self, event): if hasattr(self, _click_pending) and self._click_pending: return # 忽略重复点击 self._click_pending True self.root.after(100, lambda: setattr(self, _click_pending, False)) # 100ms 锁定 grid_pos self.board.pixel_to_grid(event.x, event.y) if grid_pos: r, c grid_pos if self.state.select_cell(r, c): # ... 重绘逻辑辅助方案GameState.select_cell()方法开头加if self._busy: return Falseself._busy True/finally: self._busy False但不如节流彻底。4.4 现象撤销功能 (CtrlZ) 按下后格子恢复但图片错位或恢复成错误图标原因history中只存了(r1,c1,r2,c2,old_icon1,old_icon2)但未保存被消除格子周围的“下落”状态如上方格子是否已下落导致恢复时坐标错乱。解决撤销时不仅恢复图标还要恢复整个棋盘快照def _remove_pair(self, r1, c1, r2, c2): # 深拷贝当前 grid 状态用 tuple 避免嵌套 list 问题 snapshot tuple(tuple(row) for row in self.grid) self.history.append((snapshot, r1, c1, r2, c2)) # ... 执行消除撤销时直接self.grid [list(row) for row in snapshot]确保状态原子性。4.5 现象Windows 上打包的 exe 双击无反应任务管理器里进程一闪而逝原因缺少--console参数导致错误信息被吞实际是PIL或tkinter初始化失败如缺少 Visual C 运行库。解决开发时始终用--console打包调试pyinstaller --console --add-data assets;assets game.py发布版可去掉--console但必须在try/except中捕获顶层异常并弹窗if __name__ __main__: try: main() except Exception as e: import tkinter.messagebox as msgbox msgbox.showerror(启动失败, f请检查环境{str(e)}\n\n详细错误{traceback.format_exc()}) sys.exit(1)5. 进阶实战打包成跨平台独立 exe 添加音效 实现下落动画5.1 用 PyInstaller 打包一份配置搞定 Windows/macOS/Linux打包不是pyinstaller game.py一行命令就完事。真实项目需定制 spec 文件控制细节# game.spec # -*- mode: python ; coding: utf-8 -*- block_cipher None a Analysis( [game.py], pathex[.], binaries[], datas[ (assets, assets), # 确保 assets 目录完整复制 (fonts, fonts), # 如需自定义字体 ], hiddenimports[PIL._tkinter_finder], # 关键否则 tkinterPIL 打包失败 hookspath[], hooksconfig{}, runtime_hooks[], excludes[], win_no_prefer_redirectsFalse, win_private_assembliesFalse, cipherblock_cipher, noarchiveFalse, ) pyz PYZ(a.pure, a.zipped_data, cipherblock_cipher) exe EXE( pyz, a.scripts, a.binaries, a.zipfiles, a.datas, [], namelianliankan, debugFalse, bootloader_ignore_signalsFalse, stripFalse, upxTrue, consoleTrue, # 开发期保留控制台发布时改为 False disable_windowed_tracebackFalse, argv_emulationFalse, target_archNone, codesign_identityNone, entitlements_fileNone, )执行打包# 生成 spec 文件首次 pyinstaller game.py # 修改 game.spec 后用 spec 文件构建 pyinstaller game.spec # 发布版无控制台图标版本信息 pyinstaller --noconsole --iconassets/icon.ico --version-fileversion.txt game.spec注意hiddenimports[PIL._tkinter_finder]是 tkinter PIL 混合使用的必备项否则打包后ImageTk.PhotoImage报错AttributeError: module PIL has no attribute _tkinter_finder。5.2 添加音效用playsound实现零依赖短音播放不要引入pygame.mixer体积大、初始化慢。playsound轻量且跨平台pip install playsoundfrom playsound import playsound import threading class SoundPlayer: staticmethod def play_sound(name): 异步播放音效不阻塞 UI sound_path os.path.join(res_mgr.base_path, assets, sounds, f{name}.wav) if os.path.exists(sound_path): # 用线程避免阻塞主线程 threading.Thread( targetplaysound, args(sound_path,), daemonTrue ).start() # 使用示例消除时播放 if self.can_connect(...): SoundPlayer.play_sound(clear) self._remove_pair(...)音效文件要求格式WAVplaysound对 MP3 支持不稳定采样率22050 Hz 或 44100 Hz时长≤ 0.5 秒过长音效会干扰操作节奏存放路径assets/sounds/clear.wav打包时自动包含。5.3 下落动画用canvas.move()实现平滑位移而非瞬移消除后上方格子应“掉落”填补空缺。瞬移 (grid[r][c] grid[r-1][c]) 体验生硬。用canvas.move()做逐帧动画def animate_fall(self, r_from, c, r_to): 动画将 (r_from,c) 格子移动到 (r_to,c) if (r_from, c) not in self.items: return item_id self.items[(r_from, c)] dy (r_to - r_from) * self.board.cell_size steps 10 step_dy dy / steps def move_step(i): if i steps: self.canvas.move(item_id, 0, step_dy) self.root.after(16, lambda: move_step(i1)) # ~60fps else: # 动画结束更新逻辑坐标 self._update_grid_position(r_from, c, r_to, c) move_step(0) def _update_grid_position(self, old_r, old_c, new_r, new_c): 更新 grid 数组并修正 items 缓存 icon self.state.grid[old_r][old_c] self.state.grid[old_r][old_c] None self.state.grid[new_r][new_c] icon # 更新缓存 key if (old_r, old_c) in self.items: self.items[(new_r, new_c)] self.items.pop((old_r, old_c))动画参数说明steps1010 帧完成位移16ms间隔 ≈ 60fpsdy (r_to - r_from) * cell_size总位移像素与格子尺寸强绑定move_step递归调用root.after避免time.sleep阻塞 UI 线程。5.4 最终验证清单你的源码是否达到“可交付”标准检查项验证方法不合格表现跨平台运行在 Windows 10/11、macOS 12、Ubuntu 22.04 上双击 exe 运行任一平台闪退、黑屏、报错DPI 自适应在 Windows 设置中切换 100%/125%/150% 缩放观察按钮、文字、格子是否等比缩放文字模糊、按钮溢出、格子挤压变形资源打包完整性删除本地assets/目录运行打包后的 exe图片变灰块、音效无声、启动报错撤销可靠性连续消除 5 对 → 按 CtrlZ 5 次 → 棋盘应回到初始状态图标错位、空格变实、步数未回退高频点击鲁棒性用鼠标快速点击不同格子≥5次/秒观察是否漏响应或状态错乱点击无反馈、选中状态粘滞、消除失败我上线过的所有连连看项目都带着这份清单过三轮测试自己测、同事盲测、外包 QA 测。最后一关永远是“让一个没接触过代码的产品经理在 10 分钟内找出所有 bug”。当她笑着指着“这个格子点三次才消失”说“你们程序员真轴”时我知道这版源码可以交付了。希望帮到你。本文还有配套的精品资源点击获取
