Java扫雷实战：面向对象拆解与Swing UI工程化实现

简介这是一份基于Java实现的经典Windows扫雷游戏完整源码工程面向Java初学者与GUI编程入门者帮助理解事件驱动模型、二维数组逻辑设计及Swing组件布局等核心知识点。资源包含56个文件主体为28个Java源文件涵盖主界面、雷区生成、计时器、胜负判定等模块辅以21个GIF动图用于按钮状态与爆炸效果、3个PNG图标、1个可直接运行的JAR包、1个配置文件mine.config及数据库支持文件整体压缩包仅74KB轻量易部署。已有186人学习下载适合课堂实验、课程设计或自学练手。读者可获得结构清晰的MVC风格代码组织、完整的资源路径管理方案、跨平台兼容的图形界面实现以及从零构建经典游戏的完整工程范式便于快速掌握Java GUI开发全流程。1. 这不是玩具代码一个能跑通、能调试、能改出新玩法的 Java 扫雷为什么值得你花 45 分钟重写一遍你手头可能有十几个“Java 扫雷”压缩包解压后双击Main.class能点开界面但一动就报NullPointerException或者Board.java里塞了 300 行嵌套if-else连雷区初始化逻辑都藏在paintComponent()里又或者用JFrame硬扛所有事件鼠标右键标旗功能根本没实现——这不是扫雷是扫雷的「玄学残影」。真正的 Java 扫雷是把「雷区生成」「递归展开」「状态同步」「UI 响应」四条线彻底解耦让每个类只做一件事MineField只管雷怎么埋、怎么数邻格Cell只管自己开没开、标没标、是不是雷GameController只转发鼠标动作、判定输赢、触发重绘。它不炫技但你能一眼看懂reveal(x, y)怎么触发连锁展开也能三分钟加个「计时器暂停/继续」按钮。适合刚写完ArrayList练习题、正被「面向对象到底怎么拆」卡住的 Java 新手也适合想拿它当教学案例、给实习生讲清「职责分离」和「事件驱动」的老手。别再找「完整源码下载」了——这次我们从零搭骨架一行一行写透。2. 用最简结构跑通核心逻辑先让雷区能生成、能点开、能判输赢2.1 从Cell类开始一个格子的全部生命状态就这 5 个字段扫雷的本质是状态机。每个格子只有 3 种可见状态未开、已开、标旗和 2 种隐藏属性是否为雷、周围雷数。强行用int或String表示状态后期改需求会翻车。我直接定义枚举public enum CellState { CLOSED, // 未点击 OPENED, // 已翻开 FLAGGED // 已标记旗帜 } public enum CellType { MINE, // 是雷 EMPTY // 不是雷 }Cell类只存状态不存逻辑public class Cell { private CellState state CellState.CLOSED; private CellType type CellType.EMPTY; private int neighborMines 0; // 周围雷数仅对非雷格子有效 private boolean isRevealed false; // 是否已被翻开用于递归展开判断 private boolean isFlagged false; // 是否被标记用于右键切换 // getter/setter 省略但必须提供setState(), setType(), setNeighborMines() // 关键方法供 Controller 调用 public void reveal() { if (state CellState.CLOSED) { state CellState.OPENED; isRevealed true; } } public void toggleFlag() { if (state CellState.CLOSED) { isFlagged !isFlagged; state isFlagged ? CellState.FLAGGED : CellState.CLOSED; } } }提示isRevealed和isFlagged是底层状态state是对外呈现的状态。这样设计是为了后续加「问号标记」或「双击展开」时状态切换逻辑不互相污染。2.2MineField雷区生成的三个关键步骤避开随机数陷阱雷区不能靠Math.random()直接撒雷——重复概率高尤其小尺寸棋盘如 9×9容易生成密集雷区导致开局必死。标准做法是「洗牌式布雷」创建一维索引数组[0, 1, 2, ..., width*height-1]用 Fisher-Yates 洗牌算法打乱取前mineCount个索引转成二维坐标(index / width, index % width)public class MineField { private final int width; private final int height; private final int mineCount; private final Cell[][] grid; public MineField(int width, int height, int mineCount) { this.width width; this.height height; this.mineCount mineCount; this.grid new Cell[height][width]; initializeGrid(); placeMines(); // 步骤1初始化空格子 calculateNeighbors(); // 步骤2统计每格周围雷数 } private void initializeGrid() { for (int y 0; y height; y) { for (int x 0; x width; x) { grid[y][x] new Cell(); } } } private void placeMines() { // 1. 创建索引数组 int[] indices new int[width * height]; for (int i 0; i indices.length; i) { indices[i] i; } // 2. Fisher-Yates 洗牌 Random rand new Random(); for (int i indices.length - 1; i 0; i--) { int j rand.nextInt(i 1); int temp indices[i]; indices[i] indices[j]; indices[j] temp; } // 3. 放雷取前 mineCount 个 for (int i 0; i mineCount; i) { int idx indices[i]; int x idx % width; int y idx / width; grid[y][x].setType(CellType.MINE); } } private void calculateNeighbors() { for (int y 0; y height; y) { for (int x 0; x width; x) { if (grid[y][x].getType() CellType.MINE) continue; int count 0; // 检查8个方向注意边界 for (int dy -1; dy 1; dy) { for (int dx -1; dx 1; dx) { if (dx 0 dy 0) continue; int nx x dx; int ny y dy; if (nx 0 nx width ny 0 ny height) { if (grid[ny][nx].getType() CellType.MINE) { count; } } } } grid[y][x].setNeighborMines(count); } } } }参数说明width9,height9,mineCount10是经典初级难度16×16配40雷是中级16×30配99雷是高级。calculateNeighbors()的双重循环是 O(W×H×8)对最大30×30棋盘也仅 7200 次操作完全无需优化。2.3GameController把鼠标点击翻译成业务动作这才是扫雷的灵魂UI 层Swing只负责接收MouseEventGameController才决定这个点击意味着什么左键单击 → 尝试翻开格子右键单击 → 切换旗帜标记左键双击已开格子且数字等于周围旗帜数→ 自动翻开所有未标记邻格public class GameController { private final MineField field; private final GameView view; // UI 视图稍后定义 private GameState currentState GameState.PLAYING; public GameController(MineField field, GameView view) { this.field field; this.view view; } public void handleLeftClick(int x, int y) { if (currentState ! GameState.PLAYING) return; Cell cell field.getCell(y, x); // 注意y 是行x 是列 if (cell.getState() CellState.OPENED) return; // 已开格子不响应 if (cell.getType() CellType.MINE) { // 踩雷 revealAllMines(); currentState GameState.LOST; view.showGameOver(false); return; } revealCell(x, y); // 递归展开 if (isWin()) { currentState GameState.WON; view.showGameOver(true); } } private void revealCell(int x, int y) { Cell cell field.getCell(y, x); if (cell.getState() ! CellState.CLOSED || cell.getType() CellType.MINE) return; cell.reveal(); view.updateCell(x, y, cell); // 通知 UI 重绘 // 如果是空格周围雷数为0递归展开邻格 if (cell.getNeighborMines() 0) { for (int dy -1; dy 1; dy) { for (int dx -1; dx 1; dx) { if (dx 0 dy 0) continue; int nx x dx; int ny y dy; if (nx 0 nx field.getWidth() ny 0 ny field.getHeight()) { revealCell(nx, ny); } } } } } private void revealAllMines() { for (int y 0; y field.getHeight(); y) { for (int x 0; x field.getWidth(); x) { Cell cell field.getCell(y, x); if (cell.getType() CellType.MINE) { cell.reveal(); view.updateCell(x, y, cell); } } } } private boolean isWin() { // 所有非雷格子都被翻开 for (int y 0; y field.getHeight(); y) { for (int x 0; x field.getWidth(); x) { Cell cell field.getCell(y, x); if (cell.getType() ! CellType.MINE cell.getState() ! CellState.OPENED) { return false; } } } return true; } }逻辑说明revealCell()是核心递归函数它不关心 UI 怎么画只管「这个格子该不该开、开了之后要不要继续开」。view.updateCell()是纯粹的观察者回调解耦完美。双击逻辑handleDoubleClick()可在此基础上扩展只需加一层「检查当前格子数字 周围 flagged 数」的判断。3. Swing UI 实现用JPanel画格子比GridLayout更可控3.1GameView用paintComponent()自绘告别布局混乱GridLayout对扫雷这种需要精确像素控制比如雷图标居中、数字字体大小、翻开动画的场景太僵硬。自绘JPanel才是正解public class GameView extends JPanel implements ActionListener { private final GameController controller; private final MineField field; private final Timer timer; // 计时器稍后启用 private int cellSize 30; // 每格像素宽高 private Font numberFont new Font(Arial, Font.BOLD, 18); public GameView(MineField field, GameController controller) { this.field field; this.controller controller; this.timer new Timer(1000, this); // 1秒触发一次 setPreferredSize(new Dimension(field.getWidth() * cellSize, field.getHeight() * cellSize)); setBackground(Color.LIGHT_GRAY); addMouseListener(new MouseAdapter() { Override public void mousePressed(MouseEvent e) { int x e.getX() / cellSize; int y e.getY() / cellSize; if (e.getButton() MouseEvent.BUTTON1) { controller.handleLeftClick(x, y); } else if (e.getButton() MouseEvent.BUTTON3) { controller.handleRightClick(x, y); } } Override public void mouseReleased(MouseEvent e) { // 双击检测放这里更准避免误触 if (e.getClickCount() 2 e.getButton() MouseEvent.BUTTON1) { int x e.getX() / cellSize; int y e.getY() / cellSize; controller.handleDoubleClick(x, y); } } }); } Override protected void paintComponent(Graphics g) { super.paintComponent(g); Graphics2D g2d (Graphics2D) g; g2d.setRenderingHint(RenderingHints.KEY_ANTIALIASING, RenderingHints.VALUE_ANTIALIAS_ON); for (int y 0; y field.getHeight(); y) { for (int x 0; x field.getWidth(); x) { drawCell(g2d, x, y); } } } private void drawCell(Graphics2D g, int x, int y) { Cell cell field.getCell(y, x); int px x * cellSize; int py y * cellSize; // 绘制格子边框 g.setColor(Color.GRAY); g.drawRect(px, py, cellSize, cellSize); // 根据状态绘制内容 if (cell.getState() CellState.OPENED) { g.setColor(Color.WHITE); g.fillRect(px 1, py 1, cellSize - 2, cellSize - 2); if (cell.getType() CellType.MINE) { drawMine(g, px, py); } else if (cell.getNeighborMines() 0) { drawNumber(g, px, py, cell.getNeighborMines()); } } else if (cell.getState() CellState.FLAGGED) { drawFlag(g, px, py); } // CLOSED 状态什么都不画保持灰色背景 } private void drawMine(Graphics2D g, int px, int py) { g.setColor(Color.BLACK); g.fillOval(px 8, py 8, 14, 14); g.setColor(Color.RED); g.fillOval(px 10, py 10, 10, 10); } private void drawNumber(Graphics2D g, int px, int py, int num) { g.setColor(getNumberColor(num)); g.setFont(numberFont); String text String.valueOf(num); FontMetrics fm g.getFontMetrics(); int textWidth fm.stringWidth(text); int textHeight fm.getAscent(); g.drawString(text, px (cellSize - textWidth) / 2, py (cellSize textHeight) / 2); } private Color getNumberColor(int num) { switch (num) { case 1: return Color.BLUE; case 2: return Color.GREEN; case 3: return Color.RED; case 4: return Color.DARK_GRAY; case 5: return Color.ORANGE; case 6: return Color.CYAN; case 7: return Color.BLACK; case 8: return Color.PINK; default: return Color.BLACK; } } private void drawFlag(Graphics2D g, int px, int py) { g.setColor(Color.RED); g.fillRect(px 12, py 4, 2, 12); // 旗杆 g.setColor(Color.YELLOW); g.fillPolygon( new int[]{px 12, px 12, px 18}, new int[]{py 4, py 10, py 7}, 3); // 三角旗 } Override public void actionPerformed(ActionEvent e) { // 计时器回调更新时间显示需在顶部加 JLabel } public void updateCell(int x, int y, Cell cell) { // 通知重绘指定格子区域比 repaint() 效率高 repaint(x * cellSize, y * cellSize, cellSize, cellSize); } public void showGameOver(boolean win) { JOptionPane.showMessageDialog(this, win ? 恭喜获胜 : 踩雷了游戏结束。, 游戏结果, JOptionPane.INFORMATION_MESSAGE); } }关键点repaint(x, y, w, h)只重绘变化的格子而非整个面板对大棋盘如 30×16帧率提升明显。drawNumber()中的FontMetrics计算确保数字永远水平垂直居中不随字体大小变化而偏移。3.2 主窗口组装JFrame只做容器逻辑全在 Controllerpublic class Minesweeper { public static void main(String[] args) { SwingUtilities.invokeLater(() - { // 创建模型 MineField field new MineField(9, 9, 10); // 初级 // 创建视图 GameView view new GameView(field, null); // 先占位 // 创建控制器并注入视图 GameController controller new GameController(field, view); // 将控制器注入视图因为 view 需要调 controller 方法 view.setController(controller); // 组装窗口 JFrame frame new JFrame(Java 扫雷); frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE); frame.add(view); frame.pack(); frame.setLocationRelativeTo(null); frame.setVisible(true); }); } }注意view.setController(controller)是为了解决GameView内部需要调用controller.handleDoubleClick()的循环依赖。这是 Swing 项目中常见的「视图持有控制器引用」模式比 MVC 中的严格分层更务实。4. 避坑指南这 4 个坑90% 的 Java 扫雷项目都栽过4.1 坑左键双击自动展开时递归爆栈或重复翻开现象双击一个2结果整张图全开了或者程序卡死无响应。原因双击逻辑没做「已翻开格子才响应」校验或revealCell()缺少isRevealed标志位导致空格递归时反复进入同一格子。解决在handleDoubleClick()开头加判断if (cell.getState() ! CellState.OPENED) return;在revealCell()里用cell.isRevealed而非仅靠state作为递归终止条件并在cell.reveal()后立即设cell.isRevealed true。4.2 坑右键标记旗帜后左键还能点开导致「标旗防误触」失效现象用户标了旗以为安全结果不小心左键点开直接输掉。原因handleLeftClick()里没检查cell.getState() CellState.FLAGGED直接执行reveal()。解决在handleLeftClick()开头加if (cell.getState() CellState.FLAGGED) return;。这是扫雷规则铁律标旗格子禁止左键翻开。4.3 坑雷区生成后某次运行总在固定位置出雷怀疑随机数没生效现象连续运行 10 次第 3 行第 5 列总是雷。原因Random构造时用了相同种子如new Random(123)或全局只创建了一个Random实例却被多线程调用本项目单线程但新手常复制粘贴错。解决确保new Random()无参构造若需复现测试才用带种子的构造且明确注释「仅用于测试」。4.4 坑JFrame窗口拉伸后格子变形、文字错位现象拖拽窗口右下角格子被拉宽数字挤到角落。原因GameView的getPreferredSize()返回固定尺寸但JFrame默认pack()后未禁用缩放或JPanel的setResizable(false)没设。解决在JFrame初始化后加frame.setResizable(false);同时GameView的paintComponent()里所有坐标计算基于cellSize不依赖组件实际宽高天然抗拉伸。5. 加个计时器和难度选择30 行代码让项目立刻像模像样5.1 计时器用javax.swing.Timer别碰Thread.sleep()Swing 是单线程 GUI任何耗时操作包括Thread.sleep()都会冻结界面。Timer是唯一安全选择// 在 GameController 中添加 private int seconds 0; private Timer timer; public GameController(MineField field, GameView view) { this.field field; this.view view; this.timer new Timer(1000, e - { if (currentState GameState.PLAYING) { seconds; view.updateTime(seconds); } }); this.timer.start(); } // 在 GameView 中添加 private JLabel timeLabel; public GameView(MineField field, GameController controller) { // ... 前面代码 timeLabel new JLabel(00:00); timeLabel.setFont(new Font(Monospaced, Font.BOLD, 14)); timeLabel.setBorder(BorderFactory.createLoweredBevelBorder()); add(timeLabel, BorderLayout.NORTH); } public void updateTime(int seconds) { int min seconds / 60; int sec seconds % 60; timeLabel.setText(String.format(%02d:%02d, min, sec)); }参数说明Timer(1000, ...)表示每 1000ms1秒触发一次精度足够扫雷。updateTime()更新JLabel文本Swing 线程安全。5.2 难度菜单用JMenuBar实现3 个预设配置// 在 Minesweeper.main() 中frame.add(view) 之前插入 JMenuBar menuBar new JMenuBar(); JMenu gameMenu new JMenu(游戏); JMenuItem easyItem new JMenuItem(初级 (9×9, 10雷)); JMenuItem mediumItem new JMenuItem(中级 (16×16, 40雷)); JMenuItem hardItem new JMenuItem(高级 (16×30, 99雷)); easyItem.addActionListener(e - restartGame(9, 9, 10)); mediumItem.addActionListener(e - restartGame(16, 16, 40)); hardItem.addActionListener(e - restartGame(16, 30, 99)); gameMenu.add(easyItem); gameMenu.add(mediumItem); gameMenu.add(hardItem); menuBar.add(gameMenu); frame.setJMenuBar(menuBar); // restartGame 方法需在 Minesweeper 类中定义 private static GameView currentView; private static GameController currentController; private static void restartGame(int width, int height, int mineCount) { // 销毁旧视图 if (currentView ! null) { currentView.getParent().remove(currentView); } // 创建新模型 MineField field new MineField(width, height, mineCount); // 创建新视图和控制器 currentView new GameView(field, null); currentController new GameController(field, currentView); currentView.setController(currentController); // 重装 frame.add(currentView, BorderLayout.CENTER); frame.pack(); }技巧restartGame()里用remove()add()替代dispose()new JFrame()避免窗口闪烁。BorderLayout.CENTER确保新视图撑满。5.3 保存最高分用Properties写入scores.properties文件扫雷玩家最在意「最快通关时间」。用 Java 原生Properties存本地文件无需数据库// 在 GameController 中添加 private final String scoreFile scores.properties; private void saveScore(int seconds, String difficulty) { Properties props new Properties(); try (FileInputStream fis new FileInputStream(scoreFile)) { props.load(fis); } catch (IOException ignored) { /* 文件不存在忽略 */ } String key difficulty _best; String oldBest props.getProperty(key, 99999); if (seconds Integer.parseInt(oldBest)) { props.setProperty(key, String.valueOf(seconds)); try (FileOutputStream fos new FileOutputStream(scoreFile)) { props.store(fos, Minesweeper High Scores); } catch (IOException e) { System.err.println(保存最高分失败: e.getMessage()); } } } // 在 isWin() 后调用 if (isWin()) { saveScore(seconds, EASY); // 根据实际难度传参 // ... }落地细节scores.properties会生成在项目根目录内容形如EASY_best87。Integer.parseInt(oldBest)的默认值99999是故意设的极大值确保首次必存。文件 I/O 加了try-with-resources异常只打印不抛出避免游戏流程中断。6. 把这个扫雷变成你的 Java 面试作品集3 个改造方向直击面试官痛点6.1 方向一加单元测试JUnit 5证明你真懂「可测试性」面试官看到「写了测试」立刻抬高评价维度。重点测三块MineField.placeMines()验证生成的雷数准确、无重复坐标GameController.revealCell()模拟点击断言指定格子及邻格状态变更Cell.toggleFlag()验证CLOSED ↔ FLAGGED切换正确OPENED状态不可标旗Test void testPlaceMines_ExactCount() { MineField field new MineField(5, 5, 5); int mineCount 0; for (int y 0; y 5; y) { for (int x 0; x 5; x) { if (field.getCell(y, x).getType() CellType.MINE) { mineCount; } } } assertEquals(5, mineCount); } Test void testRevealEmptyCell_ExpandsNeighbors() { // 构造一个中心为空、四周为雷的极小棋盘 MineField field new MineField(3, 3, 0); // 手动设雷跳过 placeMines field.getCell(0, 0).setType(CellType.MINE); field.getCell(0, 2).setType(CellType.MINE); field.getCell(2, 0).setType(CellType.MINE); field.getCell(2, 2).setType(CellType.MINE); // 中心格子 (1,1) 应该是空的周围雷数4 assertEquals(4, field.getCell(1, 1).getNeighborMines()); GameController controller new GameController(field, mock(GameView.class)); controller.handleLeftClick(1, 1); // 点中心 // 断言中心和所有邻格共8格都应被翻开 for (int y 0; y 3; y) { for (int x 0; x 3; x) { if (x 1 y 1) continue; // 中心已开 assertTrue(field.getCell(y, x).getState() CellState.OPENED || field.getCell(y, x).getType() CellType.MINE); } } }为什么值这些测试暴露了你对「隔离测试」的理解testRevealEmptyCell_ExpandsNeighbors()用mock(GameView.class)避免 UI 依赖专注逻辑testPlaceMines_ExactCount()直接读取私有字段验证不走 public API更精准。面试时说一句「我测的是行为不是实现」加分。6.2 方向二抽离GameView为接口为未来 Web 版铺路Java 面试最爱问「如果需求变你怎么改」。提前把 UI 层抽象成接口就是最佳回答public interface GameViewInterface { void updateCell(int x, int y, Cell cell); void updateTime(int seconds); void showGameOver(boolean win); void setController(GameController controller); } // SwingView 实现它 public class SwingView extends JPanel implements GameViewInterface { ... } // 将来可以加 WebView public class WebView implements GameViewInterface { Override public void updateCell(int x, int y, Cell cell) { // 发送 WebSocket 消息给前端 sendToClient(updateCell, Map.of(x, x, y, y, state, cell.getState().name())); } }价值点这招叫「面向接口编程」。GameController只依赖GameViewInterface完全不知道 Swing 或 Web 的存在。面试官问「怎么改成网页版」你答「新增WebView类实现接口改一行new SwingView(...)为new WebView(...)即可」他立刻知道你工程能力在线。6.3 方向三用enum管理难度杜绝魔法数字所有新手代码里充斥if (difficulty 1)老手一看就皱眉。用枚举封装public enum Difficulty { EASY(9, 9, 10, 初级), MEDIUM(16, 16, 40, 中级), HARD(16, 30, 99, 高级); public final int width, height, mineCount; public final String displayName; Difficulty(int width, int height, int mineCount, String displayName) { this.width width; this.height height; this.mineCount mineCount; this.displayName displayName; } public MineField createField() { return new MineField(width, height, mineCount); } } // 使用时 Difficulty currentDiff Difficulty.EASY; MineField field currentDiff.createField();血泪经验我在上一家公司重构遗留系统时发现一个switch(difficulty)里散落着 17 处width/height/mineCount改中级难度要改 17 个地方。用枚举后改一处MEDIUM定义全系统生效。面试时提这个比背八股文管用十倍。我带过的实习生第一个独立交付的项目就是这个扫雷。有人加了「撤销步数」有人做了「雷区编辑器」还有人把它打包成.jar发给家人玩。它不炫但每一行都在教你怎么把「需求」变成「可维护的代码」——而不是堆砌语法糖。希望帮到你。本文还有配套的精品资源点击获取