1. 项目概述从零到一用C#构建你的第一款桌面游戏最近在整理硬盘翻到了一个大学时期写的飞行棋游戏项目看着那些略显稚嫩但逻辑清晰的代码感触颇深。这个项目可以说是很多C#初学者特别是想从控制台应用转向图形界面和游戏逻辑开发的必经之路。它麻雀虽小五脏俱全涵盖了面向对象设计、事件驱动、随机数控制、状态管理等多个核心编程概念。今天我就把这个项目的完整思路、核心代码实现以及我踩过的那些“坑”重新梳理一遍并附上完整的项目源码。无论你是刚学完C#语法想找个综合项目练手还是想了解一个经典桌面游戏的实现逻辑这篇文章都能给你提供一个可以直接“抄作业”的蓝本。飞行棋的规则大家应该不陌生2-4名玩家轮流掷骰子按点数移动棋子目标是让所有棋子从起点绕棋盘一周后抵达终点途中会遇到各种“命运格子”如暂停、跳跃、互撞等增加了游戏的随机性和趣味性。我们将用C#的Windows窗体应用WinForms来实现它这是最经典、最易上手的桌面开发技术之一。2. 项目整体架构与核心类设计在动手写代码之前好的架构设计能让你事半功倍后期修改和维护也会轻松很多。对于飞行棋这种棋盘类游戏我们采用经典的MVC模型-视图-控制器思想来解耦但在WinForms中我们通常简化为“数据模型”和“界面呈现”两层。2.1 核心数据模型设计游戏的核心是数据状态。我们需要几个关键的类来承载这些状态。Player玩家类这是游戏的主角。每个玩家对象需要记录自己的基本信息如编号、颜色、名称和动态状态如所有棋子的当前位置、是否处于暂停状态等。一个常见的误区是只用一个整数表示玩家位置但飞行棋每个玩家有4个棋子。所以我设计了一个Listint来存储每个棋子的位置索引初始值都为-1表示棋子还在“基地”未起飞。public class Player { public int Id { get; set; } // 玩家编号1-4 public Color PlayerColor { get; set; } // 玩家颜色用于绘制棋子 public string Name { get; set; } public Listint ChessPositions { get; set; } // 4个棋子的位置 public bool IsInJail { get; set; } // 是否处于暂停状态 public int JailTurnsLeft { get; set; } // 还剩几回合暂停 public Player(int id, Color color, string name) { Id id; PlayerColor color; Name name; ChessPositions new Listint { -1, -1, -1, -1 }; // -1代表在基地 IsInJail false; JailTurnsLeft 0; } // 判断是否有棋子可以移动非暂停状态且有棋子不在终点或基地 public bool HasMovableChess() { // ... 具体逻辑判断 } }GameBoard棋盘类棋盘是游戏的舞台。我们需要用一个数据结构来映射棋盘上的每一个格子。最简单有效的方式是使用一个ListMapCell。MapCell是一个自定义类描述每个格子的属性比如它的类型普通、幸运轮盘、地雷、暂停等、它的坐标用于绘制、以及当前格子上有哪些玩家的哪个棋子用于碰撞检测。public enum CellType { Normal, // 普通格子 LuckySpin, // 幸运轮盘触发随机事件 Mine, // 地雷暂停一回合 Tunnel, // 时空隧道前进10步 Prison, // 监狱暂停两回合 // ... 可根据规则扩展 } public class MapCell { public int Index { get; set; } // 格子序号0起点N终点 public CellType Type { get; set; } public PointF DrawPosition { get; set; } // 在窗体上的绘制坐标 public Dictionaryint, int OccupyingChess { get; set; } // Key: PlayerId, Value: ChessIndex (0-3) public MapCell(int index, CellType type, PointF pos) { Index index; Type type; DrawPosition pos; OccupyingChess new Dictionaryint, int(); } } public class GameBoard { public ListMapCell Cells { get; private set; } private int _playerCount; public GameBoard(int playerCount) { _playerCount playerCount; Cells new ListMapCell(); InitializeBoard(); } private void InitializeBoard() { // 这里根据玩家人数计算棋盘总格数并初始化每个格子的类型和坐标 // 例如一个经典布局是4个角为玩家基地中间是环形路径 int totalCells 20 * _playerCount; // 假设每个玩家路径20格 for (int i 0; i totalCells; i) { CellType type CellType.Normal; // 根据索引i设置特殊格子例如每第5格是幸运轮盘每第7格是地雷等 if (i % 5 0) type CellType.LuckySpin; else if (i % 7 0) type CellType.Mine; // ... 计算该格子的绘制坐标这涉及到一些几何计算 PointF pos CalculatePosition(i); Cells.Add(new MapCell(i, type, pos)); } } private PointF CalculatePosition(int cellIndex) { // 将一维的格子索引映射到二维窗体坐标上形成环形或方形路径 // 这是绘图的核心算法之一 } }GameEngine游戏引擎类这是游戏的大脑负责协调所有模型对象执行游戏规则。它持有当前玩家列表、棋盘对象、当前回合玩家索引、游戏状态等待掷骰、选择棋子、动画中、结束等。所有核心的游戏逻辑如掷骰子、移动棋子、处理格子事件、判断输赢都封装在这里。public class GameEngine { public ListPlayer Players { get; private set; } public GameBoard Board { get; private set; } public int CurrentPlayerIndex { get; private set; } public GameState State { get; private set; } private Random _rng; public GameEngine(int playerCount) { _rng new Random(); Players new ListPlayer(); // 初始化玩家分配颜色 Color[] colors { Color.Red, Color.Blue, Color.Green, Color.Yellow }; for (int i 0; i playerCount; i) { Players.Add(new Player(i 1, colors[i], $玩家{i 1})); } Board new GameBoard(playerCount); CurrentPlayerIndex 0; State GameState.WaitingForRoll; } public int RollDice() { if (State ! GameState.WaitingForRoll) return 0; int dicePoint _rng.Next(1, 7); // 1-6点 // 触发后续逻辑移动棋子或处理特殊点数如6点可能多一次机会 State GameState.ChoosingChess; return dicePoint; } public bool MoveChess(int playerId, int chessIndex, int steps) { // 1. 合法性校验棋子是否存在、是否可移动、步数是否合法 // 2. 计算目标位置 // 3. 处理路径上的事件如踩到地雷 // 4. 处理目标格子的事件和碰撞如将对手撞回基地 // 5. 更新棋盘和玩家状态 // 6. 判断游戏是否结束 } }2.2 界面与模型的绑定策略WinForms是事件驱动的我们需要将上述数据模型的状态同步到UI上。我的经验是不要尝试在GameEngine里直接操作UI控件。最佳实践是GameEngine只负责更新数据模型然后触发一个自定义事件例如GameStateChanged。主窗体订阅这个事件在事件处理程序中根据最新的游戏状态去更新界面如重绘棋盘、更新提示标签、播放音效。这样做的好处是逻辑清晰GameEngine可以独立于UI进行单元测试。例如你可以写一个控制台程序来调用GameEngine的方法模拟游戏过程验证逻辑是否正确而不需要启动窗体。实操心得事件驱动的松耦合早期版本我把绘图和逻辑混在一起导致改一点UI逻辑就要动核心代码调试起来非常痛苦。后来彻底分离GameEngine变成一个纯逻辑的类库只通过事件说“现在轮到玩家2了”或者“玩家1的棋子移动到了位置15”。主窗体监听这些事件然后决定是刷新画面还是弹出对话框。这种模式让代码的维护性大大提升。3. 核心功能模块的详细实现有了清晰的架构我们就可以分模块攻克具体功能了。这几个模块是飞行棋项目的核心也是面试中常被问到的“如何设计一个XX系统”的绝佳练习。3.1 棋盘绘制与坐标计算绘制棋盘是第一个视觉挑战。我们需要在Form的Paint事件中根据GameBoard.Cells的数据将棋盘画出来。第一步确定棋盘样式。经典飞行棋棋盘是方形四个角是玩家的基地和起飞点四条边是行走路径。我们可以用一个二维坐标系来简化。假设窗体中心为原点我们先计算路径关键点拐点的坐标然后用Graphics.DrawLines或DrawCurve将这些点连接起来形成闭合路径。第二步计算每个格子的精确坐标。这是难点。你不能简单地把路径均分因为拐角处的格子密度会看起来不一样。我的方法是将整个路径的总长度像素计算出来然后根据每个格子的索引按比例在路径上插值计算出它的中心点坐标。这涉及到一些向量运算。private void MainForm_Paint(object sender, PaintEventArgs e) { Graphics g e.Graphics; g.SmoothingMode SmoothingMode.AntiAlias; // 抗锯齿让线条更平滑 // 1. 绘制棋盘底图路径、格子分隔线、特殊格子图标 Pen pathPen new Pen(Color.Black, 3); foreach (var cell in _gameEngine.Board.Cells) { PointF pos cell.DrawPosition; // 绘制格子背景根据CellType填充不同颜色 Brush cellBrush GetCellBrush(cell.Type); g.FillRectangle(cellBrush, pos.X - 15, pos.Y - 15, 30, 30); // 绘制格子边框 g.DrawRectangle(Pens.Gray, pos.X - 15, pos.Y - 15, 30, 30); // 如果需要在特殊格子上画图标如地雷符号 if (cell.Type CellType.Mine) { DrawMineIcon(g, pos); } } // 2. 绘制所有玩家的棋子 foreach (var player in _gameEngine.Players) { for (int i 0; i player.ChessPositions.Count; i) { int posIndex player.ChessPositions[i]; if (posIndex 0) // 棋子已在棋盘上 { MapCell cell _gameEngine.Board.Cells[posIndex]; // 同一个格子可能有多个棋子需要错开绘制 DrawChess(g, cell.DrawPosition, player.PlayerColor, i); } else if (posIndex -1) // 棋子在基地 { // 在玩家基地的固定位置绘制 PointF basePos GetBasePosition(player.Id); DrawChess(g, basePos, player.PlayerColor, i); } // posIndex为-2可能代表已到达终点在终点区绘制 } } } private void DrawChess(Graphics g, PointF center, Color color, int chessIndex) { // 根据棋子索引0-3在中心点周围进行微小偏移避免完全重叠 float offsetX (chessIndex % 2) * 8 - 4; float offsetY (chessIndex / 2) * 8 - 4; PointF drawPoint new PointF(center.X offsetX, center.Y offsetY); Brush chessBrush new SolidBrush(color); // 绘制圆形棋子 g.FillEllipse(chessBrush, drawPoint.X - 10, drawPoint.Y - 10, 20, 20); // 绘制棋子边框和编号 g.DrawEllipse(Pens.White, drawPoint.X - 10, drawPoint.Y - 10, 20, 20); g.DrawString((chessIndex1).ToString(), this.Font, Brushes.White, drawPoint, _stringFormat); }注意事项绘图性能与刷新如果棋盘比较复杂频繁调用this.Invalidate()重绘整个窗体可能会导致闪烁。解决方法有两个一是使用双缓冲。在窗体构造函数中设置this.DoubleBuffered true;这能有效减少闪烁。二是只重绘脏区域。但对我们这个规模的游戏来说双缓冲已经足够。另外所有Pen、Brush、Font对象都应在使用后Dispose或者作为窗体成员变量在初始化时创建避免在Paint事件中频繁创建销毁影响性能。3.2 游戏逻辑与状态机游戏本质上是一个状态机。我们需要明确定义游戏有哪些状态以及状态之间转换的条件。定义游戏状态枚举public enum GameState { NotStarted, // 游戏未开始 WaitingForRoll, // 等待当前玩家掷骰子 RollingDice, // 骰子动画中 ChoosingChess, // 掷骰子后选择移动哪个棋子当有多个棋子可移动时 MovingAnimation, // 棋子移动动画中 ProcessingEvent, // 处理格子事件如弹出对话框 PlayerSwitching, // 切换到下一个玩家 GameOver // 游戏结束 }状态流转与控制GameEngine的State属性驱动了整个游戏流程。例如当玩家点击“掷骰子”按钮时检查State是否为WaitingForRoll。调用RollDice()方法该方法内部生成随机数并根据结果比如是否掷出6点决定后续状态。如果是6点可能状态仍保持WaitingForRoll奖励再掷一次否则进入ChoosingChess。界面根据状态更新WaitingForRoll时“掷骰子”按钮可用ChoosingChess时按钮禁用同时高亮或列出当前玩家可移动的棋子供点击。玩家点击一个棋子后调用MoveChess()引擎计算移动路径和结果触发事件然后状态可能变为ProcessingEvent如果踩到地雷或PlayerSwitching。在PlayerSwitching状态引擎检查下一个玩家是否处于暂停状态如果是则自动跳过直到找到一个可行动的玩家然后将状态设回WaitingForRoll。这个状态机保证了游戏流程的严谨性避免了玩家在不该操作的时候进行操作比如动画播放时点击。3.3 棋子移动、碰撞与事件处理这是游戏逻辑最密集的部分。MoveChess方法需要处理以下情况1. 移动合法性校验棋子是否在基地位置为-1在基地时只有掷出6点或特定点数才能“起飞”移动到起飞点棋盘上对应玩家的起点格子。棋子是否已到达终点位置为-2终点棋子不可再移动。玩家是否处于暂停状态IsInJail是则本轮不能移动。2. 移动路径计算与“迭子”处理从当前位置currentPos向前移动steps步。如果路径中有“迭子”规则即自己的多个棋子可以落在同一格形成迭子可以加速移动或获得保护需要在此判断。计算目标位置targetPos。如果超过终点则需“后退”例如距离终点还剩3步但掷出5点则前进3步到终点后退2步。3. 目标格子事件触发根据Board.Cells[targetPos].Type执行不同逻辑。幸运轮盘 (LuckySpin):随机产生一个事件前进/后退若干步、与对手交换位置、获得一次免停机会等。可以创建一个随机事件列表用Random类抽取。地雷 (Mine):将当前玩家标记为暂停一回合IsInJail true; JailTurnsLeft 1;。时空隧道 (Tunnel):在当前移动步数基础上额外前进10步并需要递归处理这10步中可能触发的新事件。暂停 (Prison):暂停两回合。4. 碰撞检测与“击飞”逻辑移动前检查目标格子OccupyingChess字典。如果目标格子上有其他玩家的棋子则将该对手棋子“击飞”送回其基地将其位置重置为-1。这是飞行棋的核心对抗乐趣所在。如果目标格子上有自己的其他棋子则形成“迭子”。根据规则迭子可能获得特殊效果比如下次移动步数加倍或者仅仅是视觉上的堆叠。我们需要更新OccupyingChess字典记录这个格子上现在有哪几个棋子。// MoveChess方法中的碰撞处理伪代码 MapCell targetCell Board.Cells[targetPos]; if (targetCell.OccupyingChess.Count 0) { foreach (var kvp in targetCell.OccupyingChess.ToList()) // 使用ToList避免遍历时修改集合 { int otherPlayerId kvp.Key; int otherChessIndex kvp.Value; if (otherPlayerId ! playerId) { // 击飞对手棋子 Player otherPlayer Players.First(p p.Id otherPlayerId); otherPlayer.ChessPositions[otherChessIndex] -1; // 送回基地 targetCell.OccupyingChess.Remove(otherPlayerId); // 触发击飞动画和音效通过事件通知UI OnChessKnockedOut(otherPlayerId, otherChessIndex); } else { // 自己的棋子迭加 // 可以记录迭子数量用于后续判断 } } } // 将自己的棋子放入目标格子 targetCell.OccupyingChess[playerId] chessIndex; // 从原格子移除如果原格子在棋盘上 if (currentPos 0) { Board.Cells[currentPos].OccupyingChess.Remove(playerId); }实操心得递归事件与状态更新顺序处理“时空隧道”这类嵌套事件时要特别小心。比如棋子A踩到隧道前进10步这10步的终点可能又是一个地雷。我的实现是让MoveChess方法在完成基础移动和碰撞后返回一个MoveResult对象其中包含一个ListTriggeredEvent。主循环根据这个结果列表依次处理每个事件。处理隧道事件时会递归调用一个ProcessAdditionalSteps方法并合并其结果。关键是要确保所有状态玩家位置、格子占用、玩家暂停状态在一次“移动操作”中原子性地更新完毕再统一通知UI刷新。否则容易出现状态不一致的Bug。4. 界面交互、动画与音效增强一个光秃秃的棋盘和棋子是缺乏沉浸感的。我们需要用一些简单的动画和音效让游戏“活”起来。4.1 平滑的棋子移动动画在WinForms中实现动画本质是在一个计时器Timer的Tick事件中不断更新某个对象的位置并重绘。对于棋子移动我们不是瞬间将棋子从A点设置到B点而是计算出一个从起点到终点的路径点列表然后在动画周期内让棋子的绘制位置沿着这些路径点逐步变化。private System.Windows.Forms.Timer _animationTimer; private ListPointF _animationPath; private int _animationStep; private PointF _currentAnimatedPosition; private void StartChessAnimation(int startCellIndex, int endCellIndex, int playerId, int chessIndex) { // 1. 根据起点和终点格子索引生成路径上的关键点通常是经过的每个格子的中心坐标 _animationPath GeneratePathPoints(startCellIndex, endCellIndex); _animationStep 0; _currentAnimatedPosition _animationPath[0]; // 2. 启动计时器 _animationTimer.Interval 50; // 每50毫秒移动一步控制动画速度 _animationTimer.Start(); } private void AnimationTimer_Tick(object sender, EventArgs e) { _animationStep; if (_animationStep _animationPath.Count) { _currentAnimatedPosition _animationPath[_animationStep]; this.Invalidate(); // 触发重绘在Paint事件中会绘制_currentAnimatedPosition } else { _animationTimer.Stop(); // 动画结束正式更新游戏引擎中棋子的位置并处理到达终点的事件 _gameEngine.ConfirmAnimationEnd(_currentPlayerId, _currentChessIndex); } } // 在Paint事件中绘制动画棋子时优先使用_currentAnimatedPosition private void MainForm_Paint(object sender, PaintEventArgs e) { // ... 绘制静态棋盘 ... // 如果有正在动画的棋子用动画位置绘制 if (_animationTimer.Enabled) { DrawChess(e.Graphics, _currentAnimatedPosition, _animatingPlayerColor, _animatingChessIndex); } // ... 绘制其他静态棋子 ... }4.2 音效与反馈音效能极大提升游戏体验。你可以使用System.Media.SoundPlayer来播放简单的WAV格式音效文件。using System.Media; public class SoundManager { private readonly Dictionarystring, SoundPlayer _soundCache new Dictionarystring, SoundPlayer(); public void PlaySound(string soundName) { if (_soundCache.TryGetValue(soundName, out var player)) { player.Play(); } else { // 从资源文件或指定路径加载 string path Path.Combine(Sounds, ${soundName}.wav); if (File.Exists(path)) { player new SoundPlayer(path); _soundCache[soundName] player; player.Play(); } } } } // 在游戏引擎的关键节点调用 // _soundManager.PlaySound(dice_roll); // _soundManager.PlaySound(chess_move); // _soundManager.PlaySound(knock_out);视觉反馈同样重要当前玩家高亮在棋盘边缘或用标签醒目显示当前回合的玩家。可移动棋子提示当状态为ChoosingChess时将当前玩家可移动的棋子用发光效果或放大显示。骰子点数展示不要只显示一个数字可以用一个Label控件在掷骰子时快速变换数字模拟滚动最后定格。这只需要一个简单的计时器就能实现。4.3 游戏配置与数据持久化一个完整的游戏应该允许一些自定义设置比如玩家人数2-4、玩家名称、游戏规则是否开启迭子加速、特殊事件强度等。我们可以设计一个GameSettings类通过一个设置窗体SettingsForm来修改它并使用Json.NETNewtonsoft.Json或.NET自带的System.Text.Json将其保存到本地文件。public class GameSettings { public int PlayerCount { get; set; } 2; public string[] PlayerNames { get; set; } { 玩家1, 玩家2, 玩家3, 玩家4 }; public bool EnableSuperStack { get; set; } true; // 是否开启迭子加速 public int DiceSides { get; set; } 6; // 骰子面数可以扩展为8面或自定义 } // 保存设置 string json JsonSerializer.Serialize(settings); File.WriteAllText(settings.json, json); // 加载设置 if (File.Exists(settings.json)) { string json File.ReadAllText(settings.json); settings JsonSerializer.DeserializeGameSettings(json); }5. 项目调试、优化与扩展思路开发过程中调试和优化是保证项目质量的关键。这里分享几个我实际遇到的问题和解决方法。5.1 常见Bug与调试技巧棋子位置错乱或消失最常见的原因是Board.Cells和Player.ChessPositions的数据不同步。务必封装好更新位置的方法所有位置变更都通过一个统一的方法如GameEngine.UpdateChessPosition来处理并在这个方法内同时更新棋盘格子占用信息和玩家棋子位置信息。调试时可以添加一个“调试绘制”模式在棋盘上每个格子旁边用文字标出格子索引和当前占用者ID一目了然。事件触发顺序错误导致状态异常比如玩家A踩到地雷被暂停但紧接着因为“幸运轮盘”事件抽中了“清除所有负面状态”这个清除应该在地雷生效前还是生效后这需要仔细定义事件处理的优先级。我的做法是移动→碰撞→格子事件这是一个顺序管道。每个环节产生的事件如击飞、暂停先放入一个临时队列等整个移动管道的逻辑都走完后再按顺序处理这个队列里的事件。这样顺序是可控的。界面卡顿或闪烁除了前面提到的双缓冲还要检查是否有耗时的操作放在了UI线程比如在Paint事件中进行复杂的计算或文件读取。所有耗时操作如加载资源、计算复杂路径都应放在后台线程Task.Run或游戏初始化阶段完成。5.2 性能优化点绘图优化只重绘发生变化的部分脏矩形。但对于飞行棋这种整个棋盘都可能变化的游戏实现脏矩形比较麻烦双缓冲通常足够。确保Pen、Brush、Font等GDI对象被复用。数据查找优化频繁根据玩家ID查找Player对象可以使用Dictionaryint, Player来存储玩家列表实现O(1)的查找速度。事件去噪游戏引擎触发的事件可能很频繁要确保UI事件处理程序如OnGameStateChanged中的代码执行迅速不要在里面做繁重的计算。如果更新UI复杂可以考虑用Control.BeginInvoke来异步执行。5.3 项目扩展与进阶方向这个基础版本完成后你可以尝试添加更多功能来挑战自己网络对战功能使用System.Net.Sockets实现一个简单的TCP通信让两个实例可以联机对战。你需要设计一个通信协议同步游戏状态骰子点数、移动指令。这会让你深入理解网络同步和状态权威性谁来决定随机数结果的问题。AI对手实现一个简单的AI。最简单的AI可以随机移动可移动的棋子。进阶的AI可以评估每个移动选择的收益例如优先击飞对手、优先走向特殊格子、避免被击飞的风险这涉及到简单的博弈树搜索。更丰富的游戏内容设计更多的格子类型、道具系统如遥控骰子、路障、成就系统。这主要考验你的游戏策划和数据结构设计能力。更换游戏引擎/框架将核心的GameEngine逻辑保持不变把WinForms前端换成WPF、Unity甚至Blazor。这能让你体会不同UI框架下游戏渲染和交互逻辑的差异理解模型与视图分离的重要性。这个飞行棋项目虽然不大但它像一块很好的敲门砖敲开了游戏编程、面向对象设计、状态管理、事件驱动和UI交互等多扇大门。我提供的源码只是一个起点和参考里面必然还有可以优化和改进的地方。编程最有魅力的部分就在于你可以根据自己的想法不断地打磨和添加新功能把它变成你独一无二的作品。
