我到现在还记得第一次用Java写出“猜数字”时，黑窗口里那个跳动的反馈给我带来的兴奋感。没有数据库、没有框架、没有复杂的架构，就是Random、Scanner和while循环，却让我第一次Feel到“我写的代码真的能跑起来”。后来我陆续带过不少零基础转行的人，也帮初学者改过课程设计，慢慢沉淀出一套最适合新手的路径：用10款基础小游戏项目做Java实战，从控制台到图形界面，从变量循环到面向对象，每一步都有看得见的成果。
如果你刚学完Java基础语法，但不知道能做什么；如果你正在准备Java课程设计，却不想再写烂大街的学生管理系统；如果你想在简历上放几个拿得出手的练习项目，那这篇实战指南就是按你的需求量身定制的。我会把这10款小游戏按难度梯度拆开讲，每款对应哪些核心知识点、怎么实现、会踩什么坑，一次讲清楚。内容确实有点长，但你只要照着顺序做，基本不用再翻别的教程。
1. 项目内容设计与难度梯度安排
1.1 为什么学Java一定要做小游戏项目
很多初学者学完循环、数组、面向对象之后，陷入一个尴尬状态：语法都认识，一看例题也会，但一动手写“项目”就懵。这时候如果直接去啃Spring、MyBatis，很容易被各种概念劝退。我的建议是先做小游戏，因为游戏项目对“完成度”的要求天然低，但覆盖面又足够广。一个猜数字能训练Scanner输入、Random随机数、while循环和break；一个扫雷能训练二维数组、递归、事件监听、异常处理。更重要的是，游戏有天然的正反馈，你每改一个变量，界面上立刻能看到效果。这种即时反馈对新手建立“我能学会”的信心，比看十遍教学视频都管用。
另一个非常现实的原因：课程设计和面试。我见过太多Java课程设计交上来的是“图书管理系统”“员工考勤系统”，功能雷同、界面简陋、代码质量也一般。如果你能交一个带图形界面的贪吃蛇或飞机大战，老师的第一反应通常是“有点东西”。面试初级Java开发时，面试官问你做过什么，你说“我做过俄罗斯方块，自己实现旋转和碰撞检测”，也比说“我写过CRUD”更有记忆点。这不是鼓励大家都去做游戏，而是想说游戏项目是最能体现编程基本功的载体。
1.2 十款小游戏的难度阶梯表
这10款游戏不是随便凑的，我把它分成三个梯队。第一个梯队是控制台程序，只涉及基础语法和逻辑，适合刚学完Java SE的新手；第二个梯队开始接触数组、集合、算法梳理和简单GUI；第三个梯队是综合性的图形游戏，涉及面向对象设计、事件监听、定时器和状态管理。建议严格按顺序做，后面项目会反复用到前面项目里的思路。
| 梯队 | 游戏名称 | 主要训练知识点 | 运行形态 |
|---|---|---|---|
| 第一梯队 | 猜数字 | Random、while循环、Scanner输入 | 控制台 |
| 第一梯队 | 石头剪刀布 | switch、条件判断、随机数 | 控制台 |
| 第一梯队 | 井字棋 | 二维数组、输赢判定、函数封装 | 控制台 |
| 第二梯队 | 记忆翻牌 | 集合、洗牌算法、按钮事件、Timer | 图形界面 |
| 第二梯队 | 打地鼠 | Timer、随机坐标、事件监听、计分 | 图形界面 |
| 第二梯队 | 贪吃蛇 | 链表、方向控制、碰撞检测 | 图形界面 |
| 第三梯队 | 扫雷 | 二维数组、递归展开、右键标记 | 图形界面 |
| 第三梯队 | 2048 | 二维数组滑动合并、转置与旋转 | 图形界面 |
| 第三梯队 | 俄罗斯方块 | 多态、旋转算法、行消除、定时下落 | 图形界面 |
| 第三梯队 | 飞机大战 | 键盘监听、对象池、批量移动、碰撞检测 | 图形界面 |
有人可能会问，为什么没有把俄罗斯方块放在更前面？因为俄罗斯方块需要同时处理形状旋转、碰撞检测、行消除和定时任务，对新手来说属于“单个类能写但逻辑很容易乱”的项目，放到后面反而能激发挑战欲。如果你觉得前几个控制台项目太简单，可以直接从第二梯队的记忆翻牌开始，但我还是建议至少把井字棋完整写完，它会提前帮你建立二维坐标思维，后面扫雷和贪吃蛇都用得上。
1.3 开发环境准备：装好这三样就够
入门阶段不要折腾太复杂的工具链。我推荐的组合是：JDK 17 + IntelliJ IDEA Community Edition，再加一个记事本或者VS Code做临时记录。JDK 17目前是LTS长期支持版本，新特性对初学者友好，不会像JDK 8那样缺少一些现代化的语法糖；IDEA社区版对Java开发完全够用，自动编译、调试、重构提示都有。
JDK安装需要注意一个小点：装完之后在命令行执行java -version，如果提示找不到命令，说明没有配置JAVA_HOME环境变量。Windows用户需要在系统环境变量中新建JAVA_HOME，指向JDK安装目录，再把%JAVA_HOME%\bin加到Path里。IDEA里可以直接用内置的JDK路径，但命令行编译一定要保证javac能正常跑起来。IDEA的新版安装向导会自动识别JDK，如果你之前没配过环境变量，打开IDEA新建项目时选择18以上的SDK也能顺利写代码，但后续打jar包时还是要用到命令行工具，所以这一步别跳过。
2. 十款小游戏核心拆解与实现要点
2.1 猜数字：循环和随机数的正确打开方式
猜数字的核心逻辑只有三件事：生成一个1到100之间的随机数，循环读取玩家输入，根据大小给出提示。这个项目练的是“状态保持和跳出条件”，也就是你知道要循环，但得想清楚什么时候break。我见过很多初学者把输入放在循环外面，结果是只能猜一次；也见过有人忘了break，猜中了程序还在跑。这里直接给出一个标准骨架。
Random random = new Random(); int target = random.nextInt(100) + 1; Scanner scanner = new Scanner(System.in); int count = 0; while (true) { System.out.print("请输入你猜的数字（1-100）："); int guess = scanner.nextInt(); count++; if (guess > target) { System.out.println("大了，继续猜"); } else if (guess < target) { System.out.println("小了，继续猜"); } else { System.out.println("恭喜你猜对了，一共猜了" + count + "次"); break; } } scanner.close();这个项目还没有到需要复杂设计的程度，但有两个细节值得养成习惯。第一是scanner.close()，虽然这里不关也不会出问题，但一开始就养成释放资源的习惯，后面学到IO时不会觉得陌生。第二是random.nextInt(100) + 1这个写法，nextInt(100)生成的是0到99，加1才能变成1到100。初学者很容易直接写nextInt(100)导致永远猜不到100，这个坑我在很多学生的代码里看到过。
2.2 石头剪刀布：用枚举代替魔法数字
石头剪刀布的控制台版本看起来很简单，但它是练习“可读性设计”的好机会。通常我会建议大家先写出第一版，用int player = 1表示石头、2表示剪刀、3表示布，判断大小写一堆if；然后第二版再改成enum枚举。两版一对比，你就明白为什么正经代码里不推荐魔法数字。
public enum Gesture { ROCK, SCISSORS, PAPER; }用枚举之后，电脑随机生成一个手势，玩家输入数字后通过switch转换成枚举，胜负判断就可以封装成一个方法Result judge(Gesture player, Gesture computer)。这个项目的核心知识点是switch、枚举、静态方法设计。写完这个项目你还会发现一个规律：所有游戏都会分成“输入”“逻辑处理”“输出反馈”三个模块，这就是最早的MVC思想的雏形。
2.3 井字棋：二维数组和胜负判断
井字棋是第一梯队里最有价值的项目，因为3x3棋盘天然对应二维数组，输赢判断又是典型的逻辑枚举题。实现时建议把棋盘，也就是二维字符数组，单独抽一个Board类，把落子、判断是否有空位、判断胜负都做成方法，这样main方法里只保留游戏流程。
落子时先判断board[row][col] != ' '，有字的位置不能覆盖；胜负判断则检查三行、三列、两条对角线。下面是我常用的判断方法，逻辑清晰，新手也容易看懂：
private boolean checkWin(char[][] board, char player) { for (int i = 0; i < 3; i++) { if (board[i][0] == player && board[i][1] == player && board[i][2] == player) { return true; } if (board[0][i] == player && board[1][i] == player && board[2][i] == player) { return true; } } return (board[0][0] == player && board[1][1] == player && board[2][2] == player) || (board[0][2] == player && board[1][1] == player && board[2][0] == player); }新手常在这块把行和列搞混，尤其是检查列时容易写成board[i][0]、board[i][1]、board[i][2]，这样实际检查的是每一行前三列，并不是列。我建议画一个3x3表格，标好坐标，对照着写。这个项目会逼你把“数组下标”和“视觉位置”反复对应，后面贪吃蛇、扫雷、俄罗斯方块全是这个思路的延伸。
2.4 记忆翻牌：洗牌算法和按钮状态管理
记忆翻牌是我推荐给新手的第一个图形界面项目。界面排成4x4或者6x6的按钮网格，每对按钮背后是相同的数字或图案，玩家点击两张牌，如果匹配就保持翻开，不匹配就翻回去。核心知识点有三个：一是用Collections.shuffle()洗牌，二是按钮数组和状态映射，三是用javax.swing.Timer做延迟翻转。
生成牌面时，有一个百试不爽的小技巧：先创建一个包含n对相同元素的ArrayList，再调用Collections.shuffle，最后顺序填入按钮。这样既不会出现配对数量对不上，也不会让洗牌逻辑变得复杂。点击事件里要注意，当玩家翻开第一张牌时，不能立刻对第二张点击做判断，否则事件顺序会乱。我的做法是用一个Card firstSelected变量保存第一张牌，一个boolean isProcessing标记是否正在处理中，防止连续点击直接翻转超过两张牌。
关于延迟翻回，记住一个铁律：Swing里绝对不要用Thread.sleep()做等待。你一旦在事件线程里sleep，整个窗口就会卡死，按钮点不动、也看不到翻转效果。正确做法是Timer，配合监听器把第二张牌反回去。这个项目的难点不是逻辑，而是搞清楚“什么时候操作界面，什么时候等待”，理解了这一点，图形界面的门就算入了。
2.5 打地鼠：Timer和随机事件的组合
打地鼠和记忆翻牌难度相当，但侧重点不同。记忆翻牌练的是“状态保存”，打地鼠练的是“定时任务与随机事件”。界面上可以用6x6的按钮网格模拟地洞，一个Timer每隔一定时间随机选中一个按钮，把它变成“地鼠”，过一会儿又恢复；玩家点到地鼠按钮加一分，同时让这个地鼠立刻消失。
这里最需要控制的是“地鼠出现”和“地鼠消失”两个状态的时间重叠。我的做法是维护一个JButton currentMouseButton，如果上一次的地鼠还没消失，先把它恢复，再生成新的地鼠。这样能避免两个按钮同时变成地鼠，让玩家产生困惑。Timer的延时建议700到1000毫秒，太短了会让人反应不过来，太长了游戏没节奏。用timer.stop()控制游戏结束，并把最高分简单打印到界面上。
做这个项目时我第一次建议大家去研究“事件分发线程”的概念。Swing的所有界面更新必须发生在事件分发线程中，而Timer的task就是在事件线程里执行的，所以你可以在监听器里直接改按钮背景色、设置文字。但如果你用了Thread的sleep方法去更新界面，就一定会遇到“界面卡死但控制台还在输出”的诡异现象，后面第四节我会统一说排查方式。
2.6 贪吃蛇：链表、方向控制和碰撞检测
贪吃蛇是经典中的经典，用Java做贪吃蛇能同时练到LinkedList、键盘监听、定时刷新和碰撞检测，性价比非常高。我建议直接上Swing，把画布设计成2D网格：用一个Point对象表示蛇的一节身体，用LinkedList<Point> snake保存整条蛇。
移动的核心逻辑很有意思：每一帧在蛇头位置加上方向向量，得到新头部坐标。如果新头部坐标和食物坐标重合，就addFirst新头、不删除尾巴，相当于蛇变长；否则addFirst新头、removeLast，视觉上蛇就在向前滑动。这个“先加头再删尾”的思路，比用一个数组存整条蛇再手动移位要自然得多。
Point newHead = new Point(head.x + dx, head.y + dy); if (newHead.equals(food)) { snake.addFirst(newHead); generateFood(); } else { snake.addFirst(newHead); snake.removeLast(); }碰撞检测要检查两块：撞墙和撞自己。撞墙很简单，就是head.x < 0 || head.x >= COLS || head.y < 0 || head.y >= ROWS；撞自己则遍历snake.subList(1, snake.size())，看新头是否和身体某一节坐标相同。有一个新手问题特别隐蔽：按下方向键后，如果当前方向是向左，你按右键，程序立刻向右移动，下一帧新头会穿过自己脖子。解决方法是记录当前方向和上次方向，如果新方向和当前方向相反就直接忽略。你也可以用一个更严格的做法：所有按键先放到队列里，每帧只消费一个方向，防止快速连按导致蛇头“卡出90度转折”，这个优化做到后面会很有成就感。
2.7 扫雷：递归展开和边界条件
扫雷在外面看起来是游戏，在代码里本质是二维数组状态机。用int[][] board表示雷区，-1表示雷，0到8表示周围雷的数量；再用boolean[][] revealed和boolean[][] flagged分别表示是否翻开、是否标记。初始化时随机布雷，然后遍历每个非雷格子，数周围8个格子里有多少雷。
扫雷最经典的核心是“点开一个0，周围一片全部展开”。这是一个非常自然的递归应用。当玩家点击的格子数字为0时，递归翻开它周围的格子；如果周围某个格子也是0，则继续往里展开。但递归必须小心两个边界条件：一是坐标不能越界，二是格子不能已经翻开或者已经右键标记。我的展开方法长下面这样：
private void reveal(int x, int y) { if (!inRange(x, y) || revealed[x][y] || flagged[x][y]) { return; } revealed[x][y] = true; if (board[x][y] == 0) { for (int dx = -1; dx <= 1; dx++) { for (int dy = -1; dy <= 1; dy++) { reveal(x + dx, y + dy); } } } }你可能会问，为什么不判断“如果当前格子不为0就不递归”？上面代码已经处理了，但要注意：对于不是雷也不是0的格子，revealed[x][y] = true之后不会触发展开，因为递归调用只在board[x][y] == 0时发生，逻辑是对的。如果你把revealed[x][y] = true放在递归入口之后，再补一个“当前格子是数字1就不展开”，结果一样，但可读性会差一点。右键标记则比较简单，MouseListener里判断SwingUtilities.isRightMouseButton，切换flagged状态。
2.8 2048：滑动合并算法与方向复用
2048这个项目很能练“抽象思维”。它表面上是处理4x4数字方阵，但四个方向的滑动其实只有一套核心算法：向左滑动合并一行。只要把向左搞明白，其余方向都可以通过旋转数组、调用向左逻辑、再旋转回来实现。
向左滑动合并一行，我看到有很多新手用“两层循环 + 一堆临时变量”硬写，经常写出bug。这里我更推荐一个直观的“压缩、合并、再压缩”三步走：先去掉这一行里的所有0，把非零数字往左靠；然后从左边开始，依次把相邻相同数字合并成两倍；最后再把合并后的数组末尾补0，保证长度不变。合并时要注意：一个数字一轮里只能被合并一次，所以要有个boolean[] merged标记。
private int[] mergeLeft(int[] row) { int[] result = new int[row.length]; int index = 0; boolean[] merged = new boolean[row.length]; for (int i = 0; i < row.length; i++) { if (row[i] == 0) continue; if (index > 0 && result[index - 1] == row[i] && !merged[index - 1]) { result[index - 1] *= 2; merged[index - 1] = true; } else { result[index++] = row[i]; } } return result; }右移、上移、下移怎么复用？一个很省事的办法是：把整个棋盘转置，或者上下翻转，变成“向左”的形状，合并完再转回去。很多开源2048也是这样做的。这个项目会让你重新审视“代码复用不是复制粘贴”，也会让你对二维数组下标变换产生肌肉记忆。
2.9 俄罗斯方块：旋转矩阵与消行动态化
俄罗斯方块是10款项目里逻辑最丰满的一个。一个方块由多个方格组成，我建议用4x4的布尔矩阵或者int矩阵表示每个形状，旋转就是一个标准的矩阵坐标变换。顺时针旋转90度时，原来坐标是(row, col)，新坐标是(col, 3 - row)，因为你所在的是一个4x4的棋盘。如果形状块在某些情况下旋转会超出边界，要么阻止旋转，要么加一个“踢墙”逻辑：先尝试旋转，如果碰撞就向左或向右平移一格，看看能不能放进去。
定时下落可以用Timer，每隔800毫秒让当前方块往下移动一格，按键控制在事件监听里完成。这里最大的坑是“同时按多个键”：如果你按方向键改了下落速度，又按了左移，而代码里直接修改变量，可能出现方块扭曲。我的建议是把“当前方块的位置、形状”和“游戏地图的占用二维数组”分开，每次移动或旋转都用临时坐标算一遍，检测碰撞，碰撞失败就不更新。核心伪代码是：
boolean canMove(Block block, int newRow, int newCol) { for (Point p : block.cells()) { int r = newRow + p.x; int c = newCol + p.y; if (r < 0 || r >= ROWS || c < 0 || c >= COLS || board[r][c] != 0) { return false; } } return true; }消行时不要一边遍历一边删除，容易破坏数组索引。我的做法是：检查每一行，如果整行非0，就记录这一行要消除；然后从下往上重新生成棋盘，遇到要消除的行直接跳过，并在棋盘顶部补上一行空行。这个“反向重建”的思路比System.arraycopy连续移动多行更直观，代码也不容易出错。
2.10 飞机大战：键盘监听、对象池与碰撞检测
飞机大战是最后一个压轴项目，做完它你会觉得前面9个项目的所有知识都串起来了。玩家飞机用键盘方向键控制，子弹按固定频率向上飞，敌机从屏幕上方随机出现并向下移动，玩家子弹碰到敌机就计分并移除两者。如果敌机碰到玩家飞机则游戏结束。
设计上建议建立三个类：Player、Bullet、Enemy，都包含x, y, width, height和update()方法。所有游戏物体放在同一个ArrayList<GameObject>里统一更新和绘制。飞机大战最常见的Bug是ConcurrentModificationException，因为你通常在遍历子弹列表的同时，又有新子弹被创建并加入列表，或者删除越界的子弹。解决方法是使用Iterator来安全地删除：
Iterator<Bullet> it = bullets.iterator(); while (it.hasNext()) { Bullet b = it.next(); b.update(); if (b.y < 0) { it.remove(); } }碰撞检测最简单的做法是矩形相交判断，也就是两个对象在x和y方向上的投影区间是否有交集。不用引入引擎，手写一个intersects方法就够了。这个项目会让你的面向对象设计能力上一个台阶：你会第一次体会到“把每个游戏物体看成对象，统一走update和draw函数”所带来的代码整洁感。到这里，10个项目就算全部跑通了。
3. 实操过程与核心环节实现
3.1 从控制台到Swing：先跑通一个窗口
很多新手看到Swing代码会觉得复杂，其实它没有想象中难。任何一个图形界面程序，核心都是“窗口 + 组件 + 监听器”。先写出一个能显示的面板，再往里填逻辑。我给个最简单的空窗口模板，你可以把它当作所有图形项目的起手式：
import javax.swing.*; public class GameFrame extends JFrame { public GameFrame() { setTitle("我的小游戏"); setSize(600, 600); setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE); setLocationRelativeTo(null); setVisible(true); } public static void main(String[] args) { SwingUtilities.invokeLater(GameFrame::new); } }注意SwingUtilities.invokeLater，它的作用是让窗口创建逻辑跑在事件分发线程上。虽然你直接new GameFrame()也能看到窗口，但这是一个“标准姿势”，能避免一些奇怪的线程问题。从控制台迁移到Swing时，最需要改变的观念是：控制台程序是“顺序执行 + 循环等待”，图形程序是“初始化 + 事件驱动”。你不用再写一个大的while(true)来控制游戏流程，而是由Timer定时触发逻辑，由鼠标键盘监听触发交互。
3.2 游戏主循环的两种写法
控制台游戏和图形游戏的主循环写法完全不同。控制台猜数字、井字棋可以用while(true)加break；图形游戏用javax.swing.Timer，每16到50毫秒执行一次定时任务，相当于游戏引擎里的“帧”。我见到很多新手在图形游戏中强行套用while(true)，在run()里写Thread.sleep(50)，结果窗口完全无法响应鼠标键盘，因为事件线程被睡眠占住了。
正确做法是：
Timer timer = new Timer(16, e -> { update(); repaint(); }); timer.start();update()负责更新所有对象的位置，repaint()会调用paintComponent重绘画面。如果你有键盘监听，监听事件里只改方向键对应的标记变量，不要在事件里调用可能阻塞的方法。这样划分清晰：监听器只负责“接收输入”，Timer只负责“推进逻辑”。你把这两个角色分开，十款游戏里的任何图形项目都能搭建起来。
3.3 封装一个通用输入工具类
在做第一梯队控制台项目时，你会反复写Scanner scanner = new Scanner(System.in)和scanner.nextInt()。这里有一个常见坑：nextInt()不会消费换行符，当你紧接着调用nextLine()读字符串时，会直接读到一个空字符串。更隐蔽的是，如果用户输入的不是数字，nextInt()会抛InputMismatchException，程序直接崩溃。解决思路是做一个统一的输入工具类，把异常处理和类型转换都收口：
public class InputUtils { private static final Scanner SCANNER = new Scanner(System.in); public static int readInt() { while (true) { try { return Integer.parseInt(SCANNER.nextLine()); } catch (NumberFormatException e) { System.out.print("输入无效，请重新输入整数："); } } } }这个工具类看起来不起眼，但它会让你在写控制台游戏时少踩很多坑。后面如果想把项目扩展成“错误处理、重试逻辑”的课程设计亮点，也可以在工具类里继续加日志和限制次数。做项目时遇到重复代码，先停下来想想能不能抽成一个方法或类，这一个习惯比多写两个游戏还重要。
3.4 打包成可直接运行的jar包
项目做完之后，不能只在IDEA里能跑，要能交付出去。打包成jar包是一个很实用的加分项。在IDEA里，先保证main方法所在的类没问题，然后选择File -> Project Structure -> Artifacts -> + -> JAR -> From modules with dependencies，选择主类，再Build -> Build Artifacts。生成之后在命令行用java -jar 你的jar包.jar运行即可。
如果是纯Swing项目，没有额外依赖，打出来的jar包通常很小。我第一次打包飞机大战时忘记设置主类，双击jar包没反应，后来发现是MANIFEST.MF里没有Main-Class字段。这里建议新手多试几次命令行操作，理解一下jar包的构成。当你把一个别人双击就能玩的游戏发到朋友电脑上时，那种感觉和学习进度是完全不同的。
4. 常见问题与排查技巧实录
4.1 控制台中文乱码
十个初学者有八个会遇到中文乱码。代码里写的是System.out.println("请输入数字")，控制台里显示成乱码或问号。原因通常是编译或运行时的默认字符编码和源文件编码不一致。最简单的解决方案是：IDEA里把全局编码和项目编码都设置为UTF-8，然后在运行配置的VM options里加上-Dfile.encoding=UTF-8。如果你用命令行编译，记得用javac -encoding UTF-8 源文件.java。
这里还有一个容易忽略的点：如果你在Windows命令行里直接运行，终端用的是GBK，即使Java输出UTF-8，也可能显示乱码。这时可以在运行命令里加-Dfile.encoding=GBK。说白了，编码问题需要“源文件编码”和“运行环境编码”两头一致，光改代码不解决问题。我遇到这种问题，第一反应就是先看编译和运行命令里有没有指定编码，而不是先怀疑代码写错。
4.2 Swing窗口卡死、界面无响应
卡死90%的原因是用了Thread.sleep()或者while(true)在事件线程里。典型场景是在点击事件里写了“延迟两秒后翻牌”的逻辑，为了停顿，直接Thread.sleep(2000)，结果整个窗口界面冻结，玩家连右上角关闭按钮都不好使。解决办法前面已经提过，改成javax.swing.Timer延迟任务。如果需要做比较耗时的计算，可以用SwingWorker，把耗时任务放到后台线程，再把结果通过done()方法回传到界面线程。
判断是不是这个问题的技巧很实用：程序运行时，如果窗口可以正常拖动，但按钮点击没反应，十有八九是某个事件监听器里干了阻塞的事。你可以在监听器入口和出口各打一行日志，看看是哪一步耗时最长。卡死问题不是玄学，按这个思路定位，基本五分钟内能找出凶手。
4.3 数组下标越界
贪吃蛇、扫雷、2048、俄罗斯方块，这几个项目里数组越界频繁出现。其实越界本身不是大问题，关键是你要能看懂异常信息。Exception in thread "AWT-EventQueue-0" java.lang.ArrayIndexOutOfBoundsException: Index 4 out of bounds for length 4已经很明确：在长度为4的数组里访问了下标4。数组最大下标是长度减1。
我建议在写游戏时，所有涉及坐标的地方都做一个inRange判断，统一收口。不要在每一处都写if (x >= 0 && x < n)，而是抽一个方法：
private boolean inRange(int x, int y) { return x >= 0 && x < COLS && y >= 0 && y < ROWS; }这个方法会频繁出现在扫雷、贪吃蛇、俄罗斯方块里，越早养成习惯越不容易被这种基础错误卡住。另外，要注意二维数组的“行和列”顺序，很多越界其实是把board[x][y]写成了board[y][x]，尤其在旋转和转置之后更容易搞混。写代码前先画坐标图，能省下半小时debug时间。
4.4 键盘监听不生效
飞机大战和贪吃蛇里经常遇到键盘监听没反应的问题。最常见原因是JFrame默认焦点不在面板或画布上，键盘事件根本不会触发。解决方法是调用setFocusable(true)，并且在窗口获得焦点后把焦点请求过来。一般写法是：
panel.setFocusable(true); panel.requestFocusInWindow();还有一个小坑：如果你在keyPressed里直接调用System.out.println测试，发现打印正常，但游戏逻辑不动，那说明按键事件是收到了，问题在逻辑判断。这时候不要怀疑监听器，去检查方向变量是否被重置了、是否在另一处被覆盖了。我见过有人把dx定义在keyPressed局部变量里，结果每次按键都重置为0，游戏当然不动。用一个实例字段保存方向状态，才是正确做法。
4.5 常见问题速查表
| 问题现象 | 最常见原因 | 解决方法 |
|---|---|---|
| 控制台中文乱码 | 源文件编码和运行环境编码不一致 | 统一UTF-8，运行时加-Dfile.encoding=UTF-8 |
| 窗口点击后没反应 | Thread.sleep阻塞事件线程 | 改用Timer或SwingWorker |
| 数组越界 | 坐标忘记判断边界，或行列写反 | 抽inRange方法，画图核对下标 |
| 键盘事件完全不触发 | 组件没有焦点 | setFocusable(true)并请求焦点 |
| 贪吃蛇自己撞自己但没判判定 | 方向反转瞬间碰撞检测漏判 | 记录当前方向，反向按键直接忽略 |
| jar包双击无法运行 | MANIFEST缺少主类 | 打包时设置Main-Class，命令行测试运行 |
| 随机数每次结果都一样 | 大多是因为每次都重新new Random并且播种 | 优先使用new Random().nextInt，不要手动固定种子 |
nextInt后读不到字符串 | 换行符被留在缓冲区 | 用nextLine统一读行再parseInt |
这张表是我自己带项目时反复遇到的真实场景，你可以贴到电脑旁边。遇到问题先对号入座，解决不了的再去看具体异常信息。debug能力是练出来的，多踩几次坑之后，你甚至能凭异常堆栈的第一行判断出问题在哪个类。
5. 后续怎么把游戏项目玩出花
5.1 给十款游戏各自加一个进阶需求
10个项目全部跑通之后，不要急着学Spring，先试着做“重构和升级”。比如猜数字可以增加难度选择和猜的次数统计，存成文件，下次启动还能看历史记录；井字棋可以升级成五子棋，那就要处理任意大小棋盘和更通用的胜负判断；贪吃蛇可以加障碍物、加速、暂停、排行榜；扫雷可以加计时器和自定义难度；2048可以加撤销回退功能。这些都是很小的改动，但每一次改动都在强化你对数据结构和算法的理解。
如果你想往“找工作”的方向走，我建议从中挑一个最顺手的项目，包装成完整的课程设计或者面试项目：用Maven建立工程，把逻辑分层成model、view、controller，再加上适当注释，写一个简短的README。面试官问起来，你有具体代码、有设计思路、有踩坑经历，这套组合拳比“背八股文”强得多。Java基础面试题里常问的面向对象、泛型、集合、异常处理，都能在这一堆小游戏里找到实际案例，复习时也有画面感。
5.2 我的实操心得与学习建议
做这10个项目的过程中，你会少走很多弯路，但有三个原则我希望你记在脑子里。第一，先画图再写代码。无论是棋盘还是游戏窗口，先在纸上画出坐标，标好哪些地方是墙、哪些地方是雷、哪些地方是蛇身，再动手写。编程里大量Bug不是语法问题，而是逻辑和坐标没对上。第二，跑通比完美更重要。一上来就想着设计模式、代码重构，很容易陷入“过度设计”，给你一个最简单的方案：先用最朴素的方式把功能写出来，哪怕代码很丑，然后问自己一句“这段代码我三个月后还能看懂吗”，再决定要不要优化。第三，一定要看报错信息。新手最常犯的错是看到异常就慌，其实异常信息已经把问题位置和原因说得很明白了，从第一行开始读，顺着堆栈往下查，大多数问题都能自己解决。
这套路线我本人至少带过几十个初学者走下来，效果不说百分百，但确实能帮你在不以“背题”为目标的情况下，真正把Java基础打扎实。如果你能在完成每个项目后，把关键代码和踩坑记录整理到自己的笔记里，那这篇指南的价值会被你放得更大。动手比收藏重要得多，从猜数字开始，哪怕一行一行照敲，敲完再自己重写一遍，收获都会完全不一样。
