C#推箱子源码解析：从字符地图到状态机实现

简介这是一份面向C#初学者与游戏编程爱好者的推箱子小游戏完整源码工程适合用来练习WinForms界面开发、事件处理与游戏状态管理。压缩包共76个文件约135KB包含10个cs源文件、4个resx与resources资源文件、11个bmp位图素材、13个dat数据文件及15个way通关记录文件另有sln解决方案与csproj工程文件可直接用Visual Studio打开编译运行。功能上支持推箱子核心玩法、CtrlZ撤销与CtrlY重做、选关、存盘读盘通关后自动将最佳步数保存为level.way文件既能回放演示整个通关过程也便于向朋友分享玩家还可自行设计关卡。作者预留了自动寻路深度优先、链表与栈、鼠标操作及通关光荣榜等扩展方向适合作为课程设计或二次开发练手项目。目前已有964人学习下载。1. 一份能跑起来的 C# 推箱子源码到底值不值得拆上周有个做企业内训的朋友找我说想给新入职的应届生找个“能看懂、能改、能交作业”的 C# 练手项目翻了一圈不是 WinForm 拖控件拖到面目全非就是控制台版本连个像样的地图都没有。我把自己压箱底的一份 C# 推箱子小游戏源代码翻出来给他两百来行核心逻辑地图用字符数组存渲染走控制台规则判定和撤销逻辑都写得很干净。推箱子这个题材妙就妙在规则简单到一句话能说清但实现起来会逼着你处理二维网格、状态快照、碰撞检测、输入循环这几件 C# 入门绕不开的事。这份源码适合三类人——刚学完 C# 语法想找个完整项目练手的、要带学生做课程设计的、以及想拿个小游戏当模板改出自己玩法的。下面我按“先看懂结构、再动手跑、最后改出花样”的顺序拆。2. 先看懂这份源码的骨架字符地图与状态机怎么配合拿到一份游戏源码最忌讳上来就 F5 运行然后对着黑框发呆。推箱子的本质是一个有限状态机玩家每按一次方向键世界状态要么合法迁移人动了、箱子动了要么被拒绝撞墙、推不动。这份源码把“世界状态”压成了一个二维字符数组把“迁移规则”写成了一个判定函数结构非常值得先摸清楚再动手。2.1 地图的数据结构为什么用 char[,] 而不是对象数组源码里地图长这样// 地图元素约定# 墙 空地 . 目标点 $ 箱子 * 箱子在目标点上 // 玩家 玩家站在目标点上 private static readonly char[,] Level1 new char[,] { { #, #, #, #, #, #, # }, { #, , , ., , , # }, { #, , $, , $, , # }, { #, , , , , , # }, { #, , , ., , , # }, { #, #, #, #, #, #, # } };用char[,]而不是Box、Player这类对象是这份代码最务实的一个选择。推箱子地图通常就几十个格子用字符表示的好处是地图可以直接写在代码里当常量改关卡不用碰任何逻辑调试时Console.WriteLine打出来一眼就能看出哪格是什么判断“这格能不能走”只需要比较一个字符不用做类型转换或属性访问。代价是语义不够自解释所以源码在文件头用注释把字符约定写死了——这个习惯要保留否则过两周你自己都忘了*和谁是谁。如果你要扩展成多关卡常见做法是把每张地图抽成一个string[]用string.ToCharArray()转成二维数组再喂给逻辑层这样关卡数据可以外置到文本文件里不用重新编译。2.2 移动判定一次按键背后发生了什么核心判定函数大致是这个形状// 尝试把玩家从 (r, c) 沿 (dr, dc) 方向移动一格 // 返回 true 表示移动成功false 表示被墙或箱子挡住 private static bool TryMove(char[,] map, ref int r, ref int c, int dr, int dc) { int nr r dr, nc c dc; char target map[nr, nc]; // 撞墙直接拒绝 if (target #) return false; // 目标格是箱子或箱子在目标点上需要判断箱子能否被推动 if (target $ || target *) { int br nr dr, bc nc dc; char beyond map[br, bc]; // 箱子后面是墙或另一个箱子推不动 if (beyond # || beyond $ || beyond *) return false; // 推动箱子先还原箱子原位置再落到新位置 map[nr, nc] (target *) ? . : ; map[br, bc] (beyond .) ? * : $; } // 移动玩家先还原玩家原位置再落到新位置 map[r, c] (map[r, c] ) ? . : ; map[nr, nc] (map[nr, nc] . || map[nr, nc] *) ? : ; r nr; c nc; return true; }这段代码有几个细节值得逐行看。第一ref int r, ref int c把玩家坐标按引用传进来移动成功后直接改调用方的坐标省得再返回一个元组——这是 C# 里处理“就地更新”的常见写法但要注意别在别处误用导致坐标被意外改掉。第二箱子推动时先处理箱子再处理玩家顺序不能反否则玩家会踩到箱子原来的格子上。第三*和这两个“叠加态”字符是推箱子实现里最容易翻车的地方箱子推到目标点上要变成*从目标点上推走要还原成.玩家同理。源码用三元表达式把还原逻辑压在一行里可读性一般但逻辑是对的。判定函数返回bool而不是直接改状态好处是调用方可以据此决定要不要播放音效、要不要记一步撤销。这个“判定与执行分离”的思路比很多新手写的“在按键处理里直接改地图”要干净得多。2.3 主循环与渲染控制台游戏的输入节奏主循环是标准的“渲染—等待输入—更新”三段式while (true) { Console.Clear(); Render(map); // 逐行打印地图 Console.WriteLine(WASD 移动R 重开Q 退出); var key Console.ReadKey(true).Key; // true 表示不回显按键 int dr 0, dc 0; switch (key) { case ConsoleKey.W: dr -1; break; case ConsoleKey.S: dr 1; break; case ConsoleKey.A: dc -1; break; case ConsoleKey.D: dc 1; break; case ConsoleKey.R: Reset(map); continue; case ConsoleKey.Q: return; default: continue; } TryMove(map, ref playerR, ref playerC, dr, dc); if (IsWin(map)) { Render(map); Console.WriteLine(过关); break; } }Console.ReadKey(true)的参数true是关键它让按键不回显到控制台否则你每按一个 W屏幕上就多一个 w地图会被顶得乱七八糟。这是控制台游戏里一个很典型的坑很多新手版本就是忘了这个参数玩起来像在打字。Console.Clear()每帧清屏再重绘在格子数不多的情况下完全够用但如果地图大到几十行闪烁会明显进阶做法是用Console.SetCursorPosition做局部刷新这个放到最后一章讲。IsWin的判定逻辑很简单遍历整个地图如果还存在$没在目标点上的箱子就没赢全是*或.就算过关。这个 O(行×列) 的遍历每步都跑一次对推箱子这种规模完全无感不用提前优化。3. 把源码跑起来并改出第一个自己的关卡看懂骨架之后下一步是让它在你机器上跑通并且能改。这一章的重点不是“怎么新建项目”这种废话而是把源码落地时会遇到的几个具体动作讲清楚项目怎么建、文件怎么放、关卡怎么加、改完怎么验证没改坏。3.1 建项目与文件落位控制台项目的正确打开方式这份源码是纯控制台程序不依赖 WinForm 或 WPF所以用 .NET SDK 的命令行建项目最省事# 建一个控制台项目项目名随意这里用 SokobanDemo dotnet new console -n SokobanDemo cd SokobanDemo # 把源码里的 Program.cs 覆盖掉模板生成的 Program.cs # 如果源码是单个文件直接替换即可如果是多文件把 .cs 文件都拷进项目根目录如果你用的是 Visual Studio新建“控制台应用.NET”项目后把Program.cs的内容整体替换成源码内容就行。这里有个容易忽略的点源码如果用了Console.ReadKey在某些终端环境比如部分 IDE 的内置运行窗口里按键捕获会不灵表现为按了没反应。遇到这种情况别急着怀疑逻辑先换成系统自带的终端或命令行窗口跑一次大概率就好了。这是环境问题不是代码问题血泪经验。项目建好后先别改任何逻辑原样跑一遍确认能移动、能推箱子、能过关。这一步是基线后面改坏了可以随时回退对比。3.2 加一张新关卡从字符画到可玩地图加关卡是这份源码最实用的改造点。假设你要加一张 8×8 的地图做法是先在纸上或文本编辑器里用约定字符画出来再转成char[,]。比如// 新增关卡注意每行字符数必须一致否则编译期就会报数组维度不匹配 private static readonly char[,] Level2 new char[,] { { #, #, #, #, #, #, #, # }, { #, , , , #, , , # }, { #, , $, ., , , $, # }, { #, , , , , ., , # }, { #, , , , #, , , # }, { #, #, #, #, #, #, #, # } };画地图时有三个硬约束必须守住。第一每行字符数必须完全一致C# 的多维数组初始化要求矩形少一个字符编译就过不去。第二箱子数必须等于目标点数否则要么永远过不了关要么一开局就“赢”了。第三玩家必须恰好一个且不能初始就站在箱子上。这三条建议做成一个校验函数在加载关卡时跑一遍// 关卡合法性校验箱子数 目标点数玩家恰好一个 private static bool ValidateLevel(char[,] map) { int boxes 0, goals 0, players 0; foreach (char ch in map) { if (ch $ || ch *) boxes; if (ch . || ch * || ch ) goals; if (ch || ch ) players; } return boxes goals players 1; }注意*同时计入箱子和目标点同时计入玩家和目标点这个计数口径要和你的字符约定严格对齐否则校验会误报。加完关卡后把主循环里的Level1换成Level2跑一遍重点看两件事箱子推到目标点上有没有变成*从目标点上推走有没有还原成.。这两个叠加态的转换是推箱子实现里最容易写错的地方改关卡时一定要手动验证一遍。3.3 加撤销功能状态快照的两种存法原版如果没有撤销加一个是很自然的进阶需求。推箱子的撤销本质是“回到上一步的完整地图状态”有两种存法一是每步把整个char[,]深拷贝一份压栈二是只记录“这一步动了谁、从哪到哪”。前者实现简单但内存随步数线性增长后者省内存但回放逻辑容易写错。对推箱子这种小地图我一般直接用深拷贝简单可靠// 用栈保存历史地图每步移动前压入当前状态 private static readonly Stackchar[,] History new Stackchar[,](); private static char[,] Clone(char[,] src) { var copy new char[src.GetLength(0), src.GetLength(1)]; Array.Copy(src, copy, src.Length); return copy; } // 在 TryMove 调用前History.Push(Clone(map)); // 撤销时if (History.Count 0) map History.Pop();Array.Copy对二维数组是按行优先展平后拷贝的对char[,]这种值类型数组是逐元素复制不存在引用共享问题可以放心用。要注意的是如果你把map做成了static readonly就没法整体替换引用得改成普通static字段或者用ref传递。这个细节不改的话撤销功能会“看起来写了但不生效”排查起来很费时间。4. 推箱子实现里最容易翻车的几个点这份源码逻辑不复杂但推箱子这个玩法本身有几个反直觉的边界新手照着改十有八九会踩。下面几条是我自己改和帮别人看代码时反复遇到的按“现象—原因—解决”记下来。4.1 箱子推到墙角后关卡死锁程序却毫无提示现象玩着玩着发现箱子被推进角落怎么推都出不来但程序不报任何错只能按 R 重开。原因推箱子的死锁判定箱子被推到非目标点的墙角属于“可解性”问题源码只做了单步合法性判定没做全局死锁检测。解决如果只是练手接受这个设定、靠重开兜底即可如果要做得像样可以在每次推箱后检查箱子是否处于“两面相邻都是墙且不在目标点”的角落是则提示“死局按 R 重开”。注意这个检测只覆盖简单墙角更复杂的死锁比如两个箱子互相卡死需要搜索算法别在小项目里过度投入。4.2 玩家站在目标点上再移动目标点消失了现象玩家走到.上变成再走开时那格变成了空格目标点没了关卡永远过不了。原因还原玩家原位置时写成了map[r, c] 没判断原来是不是。解决还原逻辑必须是map[r, c] (map[r, c] ) ? . : 箱子的还原同理。这个 bug 的隐蔽之处在于只有“玩家踩过目标点”这一种路径才会触发随便玩两下不一定碰上但一旦碰上就是死关。4.3 按方向键没反应换台机器又好了现象在自己电脑上 WASD 正常拷给别人运行后按键完全没反应。原因多半是运行环境的问题——某些 IDE 的内置终端对Console.ReadKey的支持不完整或者输入法处于中文状态吞掉了字母键。解决先确认对方是在系统终端里跑而不是 IDE 内置窗口再让对方切到英文输入法试一次。如果还不行把Console.ReadKey(true)换成Console.KeyAvailable轮询的写法兼容性更好但代码会复杂一些非必要不改。4.4 地图行长度不一致编译报“数组维度不匹配”现象手动画了一张新地图编译直接失败报错指向数组初始化那一行。原因char[,]的初始化要求每一行元素个数完全相同手画地图时很容易某行多一个或少一个空格。解决把地图先写成string[]每行一个字符串加载时统一校验长度// 用字符串数组存地图加载时校验矩形性报错信息更友好 private static char[,] LoadLevel(string[] rows) { int h rows.Length, w rows[0].Length; var map new char[h, w]; for (int i 0; i h; i) { if (rows[i].Length ! w) throw new ArgumentException($第 {i} 行长度 {rows[i].Length}应为 {w}); for (int j 0; j w; j) map[i, j] rows[i][j]; } return map; }这样改的好处是错误信息直接告诉你哪一行不对不用对着char[,]初始化列表数逗号。4.5 过关判定把“箱子在目标点上”误判成没赢现象所有箱子看起来都在目标点上了程序却不过关。原因IsWin里判断的是“地图中不存在$”但如果箱子推到目标点上没正确转成*比如推动逻辑里漏了目标点判断地图里就还留着$自然判不赢。解决先修推动逻辑里的叠加态转换再确认IsWin的判定口径——更稳妥的写法是同时检查“箱子数 目标点数且没有$”双重保险。这个坑和 4.2 是同一类问题的两面都是叠加态字符没处理好。5. 从能玩到好用局部刷新与关卡外置两个进阶技巧把上面这些坑填完这份源码已经是个能交作业的完整项目了。但如果想再往前一步有两个改动性价比最高也是我带人做课程设计时必提的。第一个是局部刷新替代整屏清屏。现在每步Console.Clear()再全量重绘地图小的时候还行一旦关卡放大到二三十行闪烁会很明显。改法是开局时把光标位置记下来之后每步只把变化的两三个格子重画// 开局记录地图左上角的光标位置之后只重绘变化的格子 int originTop Console.CursorTop; // 重绘单格行 r、列 c 对应屏幕上的 (originTop r, c * 2) // 乘 2 是因为每个字符后跟一个空格视觉上更像方格 Console.SetCursorPosition(c * 2, originTop r); Console.Write(map[r, c]);这里有个参数要自己调字符间距。控制台字符是等宽的但直接一个字符挨一个字符会显得挤常见做法是每个格子输出“字符空格”列坐标相应乘 2。这个乘数不是固定的取决于你想要的视觉密度试两次就有手感了。改完之后你会发现按键响应明显跟手这是控制台小游戏体验提升最直接的一招。第二个是关卡外置。把地图从代码里的char[,]挪到外部文本文件每关一个文件加载时读进来校验。好处是加关卡不用重新编译非程序员也能改。文件格式就用纯字符一行一行读空行分隔关卡// 从文本文件加载所有关卡空行分隔 private static Listchar[,] LoadLevelsFromFile(string path) { var levels new Listchar[,](); var buffer new Liststring(); foreach (var line in File.ReadAllLines(path)) { if (string.IsNullOrWhiteSpace(line)) { if (buffer.Count 0) { levels.Add(LoadLevel(buffer.ToArray())); buffer.Clear(); } } else buffer.Add(line); } if (buffer.Count 0) levels.Add(LoadLevel(buffer.ToArray())); return levels; }LoadLevel复用 4.4 里那个带校验的版本这样外部文件写错了也能给出明确报错而不是运行到一半数组越界。做完这两步这份推箱子就从“一份能跑的源码”变成了“一个能持续加关卡、体验也过得去的小框架”拿去当课程设计的底子完全够用。最后说个我自己的习惯每次改完地图或判定逻辑我都会强制走一遍“推箱子到目标点、再从目标点推走、玩家踩目标点再离开”这三步手动验证因为叠加态字符的 bug 几乎全藏在这条路径里。这个动作花不了一分钟但能省下后面半小时的排查。希望帮到你。本文还有配套的精品资源点击获取