简介一款基于Python与Pygame的圣诞节主题寻宝小游戏面向Python初学者和喜欢通过小项目动手实践的编程爱好者。游戏以圣诞节为背景玩家需用数量有限的锤子在随机位置寻找并敲击隐藏苹果每成功敲击一个即进入下一关耗尽锤子则游戏结束完整覆盖随机生成、事件监听、计分与游戏状态管理等Pygame常用知识点。压缩包仅150KB共7个文件包含6张jpg素材苹果、锤子、背景等和1份Python主程序代码结构简单可直接运行也方便阅读和二次修改。目前已有59人学习下载适合作为课程设计、编程自学或节日主题的趣味练习。借助完整源码与配套素材使用者能快速体验完整游戏流程并通过逐行理解掌握Pygame窗口创建、图像加载、键盘及鼠标控制等核心技巧为后续开发更复杂的游戏打下扎实基础。 如果你去问一个写过几年代码的人“当年学编程最有成就感的瞬间是什么”十有八九他会回答你“第一次做出来的那个小游戏居然真的能玩。”我最近指导一位零基础的朋友做了一版“python圣诞节简单寻宝小游戏”全部代码加起来不过七八十行跑通的那一刻他自己都不敢信——学完 Python 基础语法居然已经能做一个可以跟同学炫耀的小玩意了。这个游戏本身很有节日感圣诞老人把礼物不小心掉进了一片 5x5 的雪地礼物随机藏在其中一格玩家用 w/a/s/d 控制小精灵四处寻找每走一步都会收到一句“冷热提示”距离越近提示越烫限定步数内找到就算胜利。它不需要安装任何第三方库不需要配复杂环境只要电脑上能运行 Python 3.8 以上的版本把代码保存成文件直接跑就行。如果你是刚学完变量、循环、列表、函数这些基础语法正在找一个“既能巩固内容又有意思”的练手项目这篇内容正好适合你。我会把设计思路、完整代码、可视化扩展以及新手最容易踩的坑一次讲透。1. 为什么建议你把第一个小游戏做成“圣诞寻宝”1.1 游戏到底怎么玩棋盘、礼物和冷热提示先把玩法定下来。地图是一张 5x5 的雪地网格符号含义很简单.是空地*是玩家留下的脚印P是玩家当前位置。游戏开始时礼物被随机放在某个格子里玩家从左上角出发每次输入 w上、a左、s下、d右移动一格。每走完一步程序会计算玩家当前格子到礼物格子的曼哈顿距离再用“冰天雪地”“有点凉”“温温的”“有点烫手”“特别热”来给你温度提示。你需要在 10 步之内靠这些提示锁定礼物位置。这种设计不是随便拍的。棋盘范围不能太大5x5 对新手来说足够有探索感又不会让寻宝变成大海捞针距离提示不能太精确否则就变成了直接抄答案失去推理乐趣步数限制则制造了恰到好处的紧张感。整套规则如果拿掉圣诞包装就是一个非常经典的“热-冷”教学小项目加上圣诞老人的故事线之后写代码的动力和写完之后的成就感完全不一样。1.2 为什么用纯标准库把环境折腾的时间全省了我见过太多新手把时间浪费在配环境上。做这个项目你需要安装的只有 Python 本身3.8 及以上版本都跑得动不管是 Windows、macOS 还是 Linux 都一样。不需要纠结 VSCode 还是 PyCharm不需要装第三方扩展包更不用去下载什么 cv2、numpy。你只需要有一个能运行 .py 文件的 Python 环境把代码保存为treasure.py终端执行python treasure.py就能开始游戏。我不是说 pygame 这些库不好而是对刚学完语法的新手来说第一课应该是“用最简单的工具写出一个完整的程序”而不是先被环境折腾到怀疑人生。等这个项目跑通你对 Python 基础语法的信任感会提高一大截那时候再往 pygame、爬虫这些方向扩展心态会完全不同。2. 写代码前先想清楚地图、距离和回合节奏2.1 二维列表与坐标体系先把“行”和“列”的说法统一很多新手写程序时最容易翻车的不是语法而是坐标。在这个游戏里地图天然是一张二维表所以我会用row表示第几行用col表示第几列位置统一用元组(row, col)表示。比如(0, 0)是左上角(4, 4)是右下角。初始化地图的代码是SIZE 5 game_map [[.] * SIZE for _ in range(SIZE)]这里如果你写成[[.] * SIZE] * SIZE会踩到一个经典坑因为列表乘法的浅拷贝机制每一行实际上指向同一个列表对象修改其中一格会同时改掉整列的地图数据。我用列表推导式重新生成每一行就是故意避开这个坑这个细节值得新手特别留意。礼物不需要提前画在地图上它只存在于程序逻辑里。创建礼物坐标时要保证它和玩家出生点不重合否则开局就“踩中”礼物游戏直接结束没有体验可言。这部分用一个while小循环判断即可下面代码里有完整实现。2.2 冷热提示的本质曼哈顿距离很多读者可能会问为什么不直接告诉玩家直线距离因为这是一个网格地图角色只能横平竖直地走不能斜着飞。所以从 A 点走到 B 点实际需要的最短步数是曼哈顿距离而不是欧几里得距离def distance(pos1, pos2): return abs(pos1[0] - pos2[0]) abs(pos1[1] - pos2[1])这个公式算出来的就是“绝对行差 绝对列差”恰好对应网格游戏中需要走的格子数。把距离映射成提示时我用一组数字做了分层距离提示语玩家感受0找到了命中目标1特别热就在旁边非常接近2有点烫手很近啦近在咫尺3温温的方向对头。大致正确4有点凉还得再找找。方向存疑5 及以上冰天雪地离礼物还远得很距离很远距离相同的两个格子可能在地图上方向完全相反但这份提示没有给玩家方向信息只给温度信息所以玩家必须靠多走几步来比对不同位置的“温度变化”推理出礼物的大致方向。一款好的小游戏反馈系统往往比画面更重要这就是这套设计的核心。2.3 回合节奏步数是唯一资源如果玩家可以无限次数地猜那这个游戏本质上就是“穷举找目标”玩一遍就没意思了。所以我把步数设成硬资源默认给 10 步10 步之内找到礼物算赢没找到就得重开。这样一个局在 1 分钟左右结束节奏很舒服。这里有个交互细节值得说一下我规定只有“有效移动”才扣步数也就是成功从一个格子挪到另一个相邻格子时才扣 1 步。输入的方向不合法或者一头撞上地图边界都只提示错误、不扣步数。这样对新手特别友好也不会因为手滑一次就导致整局失败。3. 核心代码拆解一份可以直接复制的完整实现3.1 先放完整代码以下代码我建议你直接保存成treasure.py运行环境只需要有 Python 3.8。为了可读性我故意把每个功能都拆成了独立函数import random import os SIZE 5 MAX_STEPS 10 def make_map(size): return [[.] * size for _ in range(size)] def place_gift(size): return (random.randint(0, size - 1), random.randint(0, size - 1)) def distance(pos1, pos2): return abs(pos1[0] - pos2[0]) abs(pos1[1] - pos2[1]) def hint(d): if d 0: return 找到了礼物就在你脚下 if d 1: return 特别热就在旁边 if d 2: return 有点烫手很近啦 if d 3: return 温温的方向对头。 if d 4: return 有点凉还得再找找。 return 冰天雪地离礼物还远得很 def clear_screen(): os.system(cls if os.name nt else clear) def show_map(game_map, player): for r in range(SIZE): line [] for c in range(SIZE): if (r, c) player: line.append(P) elif game_map[r][c] *: line.append(*) else: line.append(.) print( .join(line)) print() def move(player, direction): r, c player if direction w: r - 1 elif direction s: r 1 elif direction a: c - 1 elif direction d: c 1 return (r, c) def is_inside(pos): return 0 pos[0] SIZE and 0 pos[1] SIZE def main(): print( * 40) print(圣诞老人寻宝大行动) print(礼物掉进了 5x5 的雪地里) print(f你有 {MAX_STEPS} 步机会用 w/a/s/d 移动) print( * 40) game_map make_map(SIZE) player (0, 0) gift place_gift(SIZE) while gift player: gift place_gift(SIZE) steps MAX_STEPS while steps 0: clear_screen() show_map(game_map, player) print(f剩余步数{steps}) cmd input(请输入移动方向).strip().lower() if len(cmd) ! 1 or cmd not in (w, a, s, d): print(无效输入请输入 w/a/s/d 单个字母) input(按回车继续...) continue new_pos move(player, cmd) if not is_inside(new_pos): print(撞到雪堆了换个方向走。) input(按回车继续...) continue player new_pos steps - 1 game_map[player[0]][player[1]] * d distance(player, gift) print(hint(d)) if d 0: print(f太棒了你用 {MAX_STEPS - steps} 步找到了礼物) print(孩子们可以过个温暖的圣诞节啦) break input(按回车继续...) else: print(f很遗憾{MAX_STEPS} 步走完了还没找到。) print(f礼物其实在 {gift[0] 1} 行 {gift[1] 1} 列圣诞老人哭晕在雪地里。) if __name__ __main__: main()3.2 逐段拆解这些代码背后的逻辑第 1 到 10 行是常量和工具函数。make_map用列表推导式创建地图place_gift用random.randint(0, size - 1)生成 0 到 4 之间的随机坐标注意一定要减 1否则生成 5 就已经越界了。这是新手特别容易犯的一个经典错误很多index out of range报错都是从这里冒出来的。show_map函数负责把地图渲染成一行一行的文本。它没有直接修改地图里的P字符而是遍历整个地图根据坐标关系临时判断当前位置输出什么符号。这样玩家所在格子的脚印不会被覆盖代码也更清晰。如果你把P直接写进game_map对应格子那么每次移动都要记得把上一个位置恢复成*很容易漏。主循环里我加了两个if分支来保障游戏体验。第一个分支检查输入是否合法这里有个小细节len(cmd) ! 1和cmd not in (w, a, s, d)必须同时判断。如果你只写cmd not in wasd玩家输入wasd这种连串字符串也能通过检查因为 Python 会检查子串是否在字符序列里更稳妥的做法是像上面这样放进元组里做成员判断并加上长度校验。第二个分支检查移动后是否越界用is_inside统一管理边界判断以后如果要改地图大小只需要改这一个函数。值得一提的是代码末尾的while...else结构。while循环正常结束这里指步数扣完导致steps 0不成立时程序会走进else分支如果是通过break跳出的则不会执行else。很多 Python 初学者不知道这个语法但它在“找没找到”的场景里非常好用避免了你额外用一个found标志变量去记录状态。3.3 为什么把功能拆成函数而不是全塞进 main新手写代码最自然的倾向是把所有逻辑都写在main()里跑得通就觉得完事了。但一旦跑不通你会发现调试体验很痛苦到处都是 print根本不知道是哪个环节出了问题。把功能拆成小函数之后每个函数都能单独审查。比如你想确认move这个函数是不是真的按照 w 上 s 下的规则移动直接打印这个函数的返回值就行。拆函数的另一个好处是玩法扩展时会特别顺手。想把地图改成 8x8只需要改SIZE常量想让距离提示更夸张就改hint里的文案想限制玩家不能踩同一格就加一个已访问格子的集合。这就是“高内聚低耦合”在入门项目里的最初体验它比任何设计模式教程都直观。4. 只用标准库还能做出画面感turtle可视化扩展走读4.1 为什么选 turtle 而不是 pygame命令行版本跑通之后很多人会问能不能做成图形界面的能但我不会推荐新手第一步就去用 pygame。因为 pygame 需要额外安装还需要理解窗口循环、事件系统这些概念对刚入门的人来说信息量有点大。而 Python 自带一个 turtle 海龟绘图模块不需要安装任何东西也能画出彩色网格、雪人和礼物盒子足够用来做这个寻宝游戏的可视化版本。turtle 的学习曲线很平滑它本质上就是“画笔”编程你告诉海龟往前、转弯、抬笔它就在画布上留下轨迹。用它来画一个 5x5 的棋盘刚好能巩固循环和函数的知识也为以后接触 GUI 编程打下一个“事件驱动”的直觉。4.2 画网格、雪人和脚印的基本思路画网格的代码核心就是两层循环。首先要解决坐标系问题turtle 画布的中心是(0, 0)而二维列表的第一个索引是行第二个是列两者方向并不一致。所以需要一个转换函数import turtle SIZE 5 CELL 80 def to_xy(row, col): x (col - 2) * CELL y (2 - row) * CELL return x, y def draw_grid(): turtle.speed(0) turtle.penup() for r in range(SIZE 1): y to_xy(r, 0)[1] turtle.goto(-CELL * 2, y) turtle.pendown() turtle.forward(CELL * SIZE) turtle.penup() for c in range(SIZE 1): x to_xy(0, c)[0] turtle.goto(x, CELL * 2) turtle.pendown() turtle.forward(CELL * SIZE) turtle.penup()to_xy(row, col)里x跟着列走y跟着行走再把每一格的长度CELL乘进去地图中心正好落在画布中央。写到这里你大概也发现了turtle 会把前面在命令行里反复强调的坐标问题用图形的方式再复习一遍这反而是件好事。玩家的“雪人”可以画成一个圆形身体加一个三角形帽子礼物位置在程序中仍然隐藏只有当玩家移动到礼物格子时才在对应坐标画一个礼物盒子。每次移动后把上一格变成脚印颜色再把雪人画到新位置——这个重绘逻辑和命令行版本里的show_map是同一种思路只是从字符换成了图形。4.3 键盘事件turtle 版的“输入处理”命令行版本用input()阻塞等待输入但图形界面不能这么做否则窗口会卡死。turtle 用的是事件驱动先注册回调函数然后让程序进入主循环screen turtle.Screen() screen.tracer(0) turtle.listen() turtle.onkey(go_up, Up) turtle.onkey(go_down, Down) turtle.onkey(go_left, Left) turtle.onkey(go_right, Right) screen.mainloop()go_up这些函数内部做的事跟命令行版本一样更新玩家坐标、判断是否踩中礼物、调用重绘函数。注意注册完键盘事件之后一定要调用screen.mainloop()或turtle.done()程序才能持续监听按键否则窗口闪一下就没反应了这是新手问得最多的问题。如果你在可视化版本里用while True加time.sleep()的方式控制刷新节奏会发现按键响应非常卡顿。正确做法是用screen.tracer(0)关闭自动刷新然后在事件回调里手动screen.update()画面既流畅逻辑又清晰。这个思路以后写任何需要高频重绘的图形程序都用得上。5. 新手必踩的四个坑先帮你踩一遍省得走弯路5.1 坐标系反转把行当成列走两步就迷路我在指导朋友写这个项目时他第一次跑通后兴高采烈地让我玩一局。结果我输入“下”的时候雪人往右跑了。排查了半天发现他在move函数里把s写成了列加一。看起来很“好笑”的 bug背后其实是很本质的问题很多新手会把二维列表的game_map[row][col]和数学坐标(x, y)搞混写的时候一半用(row, col)一半用(x, y)一到边界判断就开始出错。这个项目的解法是所有函数全部统一接收(row, col)并且在变量名里直接写清楚例如用player_row, player_col而不是x, y从命名上就把错误概率压下去。如果你打算继续做 turtle 可视化更要小心turtle 画布里的x正好对应列方向y对应行方向转换时稍不留神就会把地图画歪。5.2 input() 返回的是字符串别直接拿去比较当时朋友写了一个“输入礼物坐标直接猜”的扩展代码长这样if input(猜坐标:) gift: print(猜中了)运行之后怎么输都猜不中。原因很简单input()返回的是字符串而gift是元组(2, 3)拿字符串和元组比结果永远是 False。正确做法是先把输入拆开、转成整数、再比较row, col input(猜坐标:).split(,) guess (int(row.strip()), int(col.strip())) if guess gift: print(猜中了)这里还有一层隐患如果用户输入的不是数字int()会直接抛ValueError导致程序崩溃。更健壮的写法要加上try...except来兜底。但新手阶段可以先记住一句话所有来自用户输入的数据都要先假设它是不合法的再去做业务判断。5.3 random 的种子和礼物重叠问题random.randint(0, 4)每次运行都会生成一个随机数这一点没问题。但有一种情况你会怀疑“随机失效”如果代码里调用了random.seed(0)那么之后每次启动程序生成的随机序列完全一样。这是测试时复现用的技巧不是 bug。更常见的体验问题是礼物恰好生成在玩家出生点(0, 0)开局就“脚踩礼物”非常扫兴。所以要加一个while gift player: gift place_gift(SIZE)的小循环兜底。另外random.randint的范围是闭区间0 到 4 确实能生成 4但如果配合SIZE 54 是合法的最后一个索引5 就会越界。这也是很多index out of range报错的来源。5.4 清屏命令跨平台不一致命令行版本的观感很大程度上依赖清屏。我看到很多新手在 Windows 上写os.system(clear)运行后不但没清屏反而满屏乱码。因为 Windows 用的是clsLinux 和 macOS 用的是clear。跨平台的写法是os.system(cls if os.name nt else clear)用os.name判断当前系统Windows 的nt走 cls其他系统走 clear。这个方法在写爬虫进度条、终端小工具的时候同样适用建议直接记下来。最后说一点个人的体会。我见过很多朋友收藏了一堆“100 个 Python 实战项目”“Python 入门教程”之类的资料却一直停在“看”的阶段。这种几十行的小游戏价值不在于代码量而在于它逼你把学过的语法真的用了一遍还让你体会到“设计规则”的乐趣——什么时候提示变热、步数限制设多少、撞墙扣不扣步数这些做决定的瞬间才是编程真正好玩的地方。你要是把它做出来并且跑通了建议顺手发给朋友玩一局看他们怎么在你设计的规则里转圈你会比他们更有成就感。本文还有配套的精品资源点击获取