在實(shí)際 Java 學(xué)習(xí)路徑中從掌握基礎(chǔ)語法到完成一個(gè)能寫在簡(jiǎn)歷上的綜合項(xiàng)目中間往往存在一個(gè)明顯的斷層。很多同學(xué)學(xué)完了 JavaSE 的核心知識(shí)卻不知道如何將這些零散的知識(shí)點(diǎn)如集合、多線程、IO、GUI串聯(lián)起來構(gòu)建一個(gè)結(jié)構(gòu)清晰、功能完整的桌面應(yīng)用程序?！把蛄藗€(gè)羊”這類消除游戲因其規(guī)則簡(jiǎn)單、邏輯明確、界面交互性強(qiáng)恰好成為了一個(gè)絕佳的練手項(xiàng)目。它不涉及復(fù)雜的網(wǎng)絡(luò)通信或龐大的第三方框架卻能全面鍛煉面向?qū)ο笤O(shè)計(jì)、事件驅(qū)動(dòng)編程和圖形界面開發(fā)的能力。本文將帶你從零開始使用純 JavaSE 技術(shù)棧不依賴任何游戲引擎完全通過手動(dòng)編碼來實(shí)現(xiàn)一個(gè)簡(jiǎn)化版的“羊了個(gè)羊”游戲。我們將從游戲的核心數(shù)據(jù)模型設(shè)計(jì)入手逐步完成圖形窗口的繪制、鼠標(biāo)事件的響應(yīng)、游戲規(guī)則的判斷直到最終形成一個(gè)可運(yùn)行、可交互的完整項(xiàng)目。這個(gè)過程不僅是為了得到一個(gè)游戲更重要的是理解一個(gè)桌面應(yīng)用從數(shù)據(jù)到視圖再到控制器的完整開發(fā)流程以及如何組織代碼、調(diào)試界面和解決開發(fā)中遇到的具體問題。完成本項(xiàng)目后你將獲得一個(gè)可用于課程設(shè)計(jì)、畢業(yè)設(shè)計(jì)或豐富個(gè)人簡(jiǎn)歷的實(shí)質(zhì)性作品并對(duì) Java 圖形界面編程有更深入的理解。1. 理解項(xiàng)目架構(gòu)與核心模型設(shè)計(jì)在動(dòng)手寫代碼之前必須先厘清游戲的核心規(guī)則和程序的數(shù)據(jù)表示方式。一個(gè)混亂的數(shù)據(jù)模型會(huì)導(dǎo)致后續(xù)的視圖渲染和邏輯控制異常復(fù)雜。1.1 游戲規(guī)則分析與抽象我們實(shí)現(xiàn)的簡(jiǎn)化版“羊了個(gè)羊”主要包含以下規(guī)則地圖與層疊所有卡牌被分為若干層堆疊在一個(gè)有限區(qū)域內(nèi)。上層的卡牌會(huì)遮擋下層的卡牌?？ㄅ祁愋陀卸喾N圖案的卡牌相同圖案的卡牌可以消除。消除規(guī)則玩家需要點(diǎn)擊選擇卡牌將其移入屏幕下方的“待消除槽”。當(dāng)槽內(nèi)出現(xiàn)三張相同圖案的卡牌時(shí)這三張卡牌會(huì)被消除騰出槽位。可用性判斷只有處于最上層且未被其他卡牌遮擋的卡牌即可見卡牌才能被點(diǎn)擊選中。游戲狀態(tài)當(dāng)所有卡牌被消除游戲勝利當(dāng)“待消除槽”被填滿且無法構(gòu)成消除時(shí)游戲失敗?；谶@些規(guī)則我們需要設(shè)計(jì)幾個(gè)核心的類模型來承載游戲狀態(tài)。1.2 核心模型類設(shè)計(jì)我們將創(chuàng)建三個(gè)核心模型類Card卡牌、Layer圖層和GameService游戲邏輯服務(wù)。Card類代表一張卡牌是游戲世界中的最小單元。屬性卡牌的唯一ID、圖案類型、坐標(biāo)位置、寬度高度、是否被選中、是否已被消除。方法判斷鼠標(biāo)點(diǎn)是否落在卡牌區(qū)域內(nèi)、繪制自身。Layer類代表一個(gè)圖層管理一組按特定布局堆疊的Card。屬性圖層名稱、圖層坐標(biāo)、行數(shù)、列數(shù)、卡牌間隔、本層所有卡牌集合。方法初始化本層卡牌設(shè)置坐標(biāo)、判斷某張卡牌在本層是否“可用”即上方無其他卡牌遮擋、繪制本層所有卡牌。GameService類游戲的大腦負(fù)責(zé)核心邏輯。屬性所有圖層的集合、待消除槽的卡牌列表、游戲狀態(tài)進(jìn)行中、勝利、失敗。方法初始化所有圖層和卡牌、處理鼠標(biāo)點(diǎn)擊事件判斷點(diǎn)擊了哪張可用卡牌、移動(dòng)卡牌到待消除槽、檢查并執(zhí)行消除、判斷游戲勝負(fù)。這個(gè)模型設(shè)計(jì)將數(shù)據(jù)卡牌狀態(tài)、組織圖層和邏輯服務(wù)分離符合面向?qū)ο蟮脑O(shè)計(jì)原則使得后續(xù)的擴(kuò)展和維護(hù)變得清晰。1.3 項(xiàng)目包結(jié)構(gòu)與依賴本項(xiàng)目?jī)H需標(biāo)準(zhǔn) JavaSE 庫無需任何外部 Jar 包。建議創(chuàng)建如下包結(jié)構(gòu)以保持代碼整潔com.yanglegeyang ├── model │ ├── Card.java │ ├── Layer.java │ └── GameService.java ├── view │ └── GameFrame.java ├── util │ └── ImageUtil.java └── AppMain.javamodel包存放上述核心模型類。view包存放游戲主窗口和繪制相關(guān)的類。util包存放工具類如圖片加載工具。AppMain.java程序入口。2. 環(huán)境準(zhǔn)備與基礎(chǔ)框架搭建在開始實(shí)現(xiàn)模型之前我們先搭建好圖形窗口的基礎(chǔ)框架并準(zhǔn)備好資源文件。2.1 創(chuàng)建項(xiàng)目與資源準(zhǔn)備在 IDE如 IntelliJ IDEA 或 Eclipse中創(chuàng)建一個(gè)普通的 Java 項(xiàng)目。在項(xiàng)目根目錄下創(chuàng)建一個(gè)res文件夾用于存放圖片資源。你需要準(zhǔn)備以下圖片card_bg.png卡牌背面或背景圖片。card_1.png,card_2.png, ...不同圖案的卡牌正面圖片例如7種圖案。slot_bg.png待消除槽的背景圖片。win.png,fail.png游戲勝利和失敗的提示圖片。將這些圖片放入res文件夾。在代碼中我們將通過類加載器來讀取這些資源。2.2 實(shí)現(xiàn)工具類與主窗口框架首先實(shí)現(xiàn)一個(gè)簡(jiǎn)單的圖片加載工具類避免在業(yè)務(wù)代碼中重復(fù)編寫資源加載邏輯。// util/ImageUtil.java package com.yanglegeyang.util; import javax.imageio.ImageIO; import java.awt.Image; import java.io.IOException; import java.net.URL; public class ImageUtil { public static Image getImage(String imageName) { // 從 classpath 的 res 目錄下加載圖片 URL resource ImageUtil.class.getClassLoader().getResource(res/ imageName); if (resource null) { throw new RuntimeException(圖片資源未找到: imageName); } try { return ImageIO.read(resource); } catch (IOException e) { throw new RuntimeException(圖片加載失敗: imageName, e); } } }接下來創(chuàng)建游戲的主窗口GameFrame。它繼承自JFrame并實(shí)現(xiàn)了MouseListener接口以響應(yīng)鼠標(biāo)點(diǎn)擊。// view/GameFrame.java package com.yanglegeyang.view; import com.yanglegeyang.model.GameService; import com.yanglegeyang.util.ImageUtil; import javax.swing.*; import java.awt.*; import java.awt.event.MouseEvent; import java.awt.event.MouseListener; public class GameFrame extends JFrame implements MouseListener { private GameService gameService; // 游戲邏輯核心 private Image offScreenImage; // 用于雙緩沖繪制的離線圖像 // 窗口尺寸 public static final int FRAME_WIDTH 800; public static final int FRAME_HEIGHT 600; public GameFrame() { initFrame(); initGame(); // 啟動(dòng)重繪線程 new Thread(this::repaintThread).start(); } private void initFrame() { this.setTitle(羊了個(gè)羊 - Java版); this.setSize(FRAME_WIDTH, FRAME_HEIGHT); this.setLocationRelativeTo(null); // 居中顯示 this.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE); this.setResizable(false); this.addMouseListener(this); this.setVisible(true); } private void initGame() { // 初始化游戲服務(wù)這里先留空后續(xù)實(shí)現(xiàn)GameService后補(bǔ)充 this.gameService new GameService(); this.gameService.startGame(); } /** * 雙緩沖繪制先在離線圖像上畫再一次性畫到窗口上避免閃爍。 */ Override public void paint(Graphics g) { if (offScreenImage null) { offScreenImage this.createImage(FRAME_WIDTH, FRAME_HEIGHT); } Graphics offScreenGraphics offScreenImage.getGraphics(); // 1. 繪制背景色 offScreenGraphics.setColor(new Color(0xF5, 0xF5, 0xDC)); // 米色背景 offScreenGraphics.fillRect(0, 0, FRAME_WIDTH, FRAME_HEIGHT); // 2. 委托GameService繪制游戲元素卡牌、槽、狀態(tài) if (gameService ! null) { gameService.paint(offScreenGraphics); } // 3. 將離線圖像繪制到窗口真正的Graphics上 g.drawImage(offScreenImage, 0, 0, null); } /** * 獨(dú)立的渲染線程控制幀率。 */ private void repaintThread() { try { while (true) { Thread.sleep(30); // 約33FPS this.repaint(); // 觸發(fā)paint方法重繪 } } catch (InterruptedException e) { e.printStackTrace(); } } // 鼠標(biāo)事件處理先留空后續(xù)實(shí)現(xiàn) Override public void mouseClicked(MouseEvent e) {} Override public void mousePressed(MouseEvent e) {} Override public void mouseReleased(MouseEvent e) { // 我們主要在鼠標(biāo)釋放時(shí)處理點(diǎn)擊邏輯 if (gameService ! null) { gameService.onMouseClick(e.getX(), e.getY()); } this.repaint(); // 點(diǎn)擊后立即重繪一次 } Override public void mouseEntered(MouseEvent e) {} Override public void mouseExited(MouseEvent e) {} }最后創(chuàng)建程序入口。// AppMain.java package com.yanglegeyang; import com.yanglegeyang.view.GameFrame; public class AppMain { public static void main(String[] args) { // 使用SwingUtilities確保GUI創(chuàng)建在事件分發(fā)線程上 javax.swing.SwingUtilities.invokeLater(GameFrame::new); } }運(yùn)行AppMain此時(shí)應(yīng)該能看到一個(gè)空白窗口?；A(chǔ)框架已經(jīng)搭建完畢。3. 實(shí)現(xiàn)核心數(shù)據(jù)模型與游戲邏輯現(xiàn)在我們來填充之前設(shè)計(jì)的核心模型類。3.1 實(shí)現(xiàn) Card 類Card類除了存儲(chǔ)屬性最關(guān)鍵的方法是isPointInCard判斷點(diǎn)擊和paint繪制。// model/Card.java package com.yanglegeyang.model; import com.yanglegeyang.util.ImageUtil; import java.awt.*; public class Card { private int id; // 唯一標(biāo)識(shí) private int type; // 圖案類型如123... private int x, y; // 卡牌左上角坐標(biāo) public static final int CARD_WIDTH 60; public static final int CARD_HEIGHT 80; private boolean isSelected; // 是否被選中在槽中 private boolean isEliminated; // 是否已被消除 // 圖片資源靜態(tài)加載一次即可 private static Image cardBgImage ImageUtil.getImage(card_bg.png); private static Image[] cardFaceImages; // 卡牌正面圖案數(shù)組 static { // 假設(shè)有7種圖案 int cardTypeCount 7; cardFaceImages new Image[cardTypeCount 1]; // 索引從1開始 for (int i 1; i cardTypeCount; i) { cardFaceImages[i] ImageUtil.getImage(card_ i .png); } } // 構(gòu)造方法、getter/setter 省略... // 重點(diǎn)實(shí)現(xiàn)以下兩個(gè)方法 /** * 判斷一個(gè)點(diǎn)(x, y)是否在當(dāng)前卡牌區(qū)域內(nèi) */ public boolean isPointInCard(int pointX, int pointY) { return pointX this.x pointX this.x CARD_WIDTH pointY this.y pointY this.y CARD_HEIGHT; } /** * 繪制卡牌 * param g 繪圖上下文 * param isTopMost 是否是頂層可用卡牌需要高亮提示 */ public void paint(Graphics g, boolean isTopMost) { if (isEliminated) { return; // 已消除的卡牌不繪制 } // 1. 繪制卡牌背景或邊框 g.drawImage(cardBgImage, x, y, CARD_WIDTH, CARD_HEIGHT, null); // 2. 如果卡牌未被選中即還在地圖上繪制正面圖案 if (!isSelected) { Image faceImg cardFaceImages[type]; if (faceImg ! null) { // 圖案比背景稍小居中繪制 int padding 5; g.drawImage(faceImg, x padding, y padding, CARD_WIDTH - 2 * padding, CARD_HEIGHT - 2 * padding, null); } } // 3. 如果是頂層可用卡牌繪制一個(gè)半透明的綠色邊框作為提示 if (isTopMost) { g.setColor(new Color(0, 255, 0, 100)); // 半透明綠色 g.fillRect(x, y, CARD_WIDTH, CARD_HEIGHT); } // 4. 如果卡牌已被選中在槽中可以繪制一個(gè)選中狀態(tài)比如紅色邊框 if (isSelected) { g.setColor(Color.RED); g.drawRect(x, y, CARD_WIDTH - 1, CARD_HEIGHT - 1); } } }3.2 實(shí)現(xiàn) Layer 類Layer類負(fù)責(zé)管理一層內(nèi)所有卡牌的布局和可用性判斷。// model/Layer.java package com.yanglegeyang.model; import java.awt.*; import java.util.ArrayList; import java.util.List; import java.util.Random; public class Layer { private String name; private int x, y; // 圖層左上角坐標(biāo) private int row; // 行數(shù) private int col; // 列數(shù) private int padding; // 卡牌間距 private ListCard cards new ArrayList(); // 本層所有卡牌 // 構(gòu)造方法、getter/setter 省略... /** * 初始化本層卡牌并設(shè)置每個(gè)卡牌的坐標(biāo)。 * param cardTypes 本層允許出現(xiàn)的卡牌類型數(shù)組 */ public void initCards(int[] cardTypes) { cards.clear(); Random random new Random(); for (int i 0; i row; i) { for (int j 0; j col; j) { Card card new Card(); card.setId(i * col j); // 隨機(jī)分配一個(gè)圖案類型 int typeIndex random.nextInt(cardTypes.length); card.setType(cardTypes[typeIndex]); // 計(jì)算坐標(biāo) card.setX(this.x j * (Card.CARD_WIDTH padding)); card.setY(this.y i * (Card.CARD_HEIGHT padding)); cards.add(card); } } } /** * 判斷指定卡牌在本層中是否是“可用”的即上方無遮擋。 * 簡(jiǎn)化算法遍歷本層所有卡牌如果存在另一張卡牌B其區(qū)域覆蓋了卡牌A的中心點(diǎn) * 且B在A的“上方”通常指列表中索引更大表示后繪制則認(rèn)為A被B遮擋。 * 這是一個(gè)簡(jiǎn)化的邏輯實(shí)際游戲可能有更復(fù)雜的層疊關(guān)系。 */ public boolean isCardAvailable(Card targetCard) { int targetCenterX targetCard.getX() Card.CARD_WIDTH / 2; int targetCenterY targetCard.getY() Card.CARD_HEIGHT / 2; for (Card otherCard : cards) { if (otherCard targetCard || otherCard.isEliminated() || otherCard.isSelected()) { continue; // 跳過自身、已消除、已選中的卡牌 } // 如果其他卡牌的區(qū)域包含了目標(biāo)卡牌的中心點(diǎn)則目標(biāo)被遮擋 if (otherCard.isPointInCard(targetCenterX, targetCenterY)) { return false; } } return true; } /** * 獲取本層所有可用的卡牌。 */ public ListCard getAvailableCards() { ListCard available new ArrayList(); for (Card card : cards) { if (!card.isEliminated() !card.isSelected() isCardAvailable(card)) { available.add(card); } } return available; } /** * 繪制本層所有卡牌。 * param g 繪圖上下文 */ public void paint(Graphics g, ListCard allTopMostCards) { for (Card card : cards) { // 判斷這張卡牌是否是全局“頂層可用卡牌”用于高亮 boolean isTopMost allTopMostCards ! null allTopMostCards.contains(card); card.paint(g, isTopMost); } } }3.3 實(shí)現(xiàn) GameService 類這是游戲邏輯的核心它串聯(lián)了所有模型并處理用戶交互。// model/GameService.java package com.yanglegeyang.model; import com.yanglegeyang.util.ImageUtil; import java.awt.*; import java.util.*; import java.util.List; public class GameService { private ListLayer layers new ArrayList(); // 所有圖層 private ListCard slotCards new ArrayList(); // 待消除槽中的卡牌最多7張 public static final int SLOT_CAPACITY 7; private GameState gameState GameState.PLAYING; private ListCard allTopMostCardsCache; // 緩存當(dāng)前所有可點(diǎn)擊的卡牌用于繪制高亮 enum GameState { PLAYING, WIN, FAIL } // 槽位繪制位置 public static final int SLOT_X 50; public static final int SLOT_Y 450; public void startGame() { initLayers(); slotCards.clear(); gameState GameState.PLAYING; refreshTopMostCardsCache(); } private void initLayers() { layers.clear(); // 示例創(chuàng)建3個(gè)圖層每個(gè)圖層圖案不同位置錯(cuò)開 Layer layer1 new Layer(Layer1, 100, 100, 3, 4, 5); layer1.initCards(new int[]{1, 2, 3}); // 第一層只有123三種圖案 layers.add(layer1); Layer layer2 new Layer(Layer2, 120, 130, 3, 4, 5); layer2.initCards(new int[]{2, 3, 4}); layers.add(layer2); Layer layer3 new Layer(Layer3, 140, 160, 2, 3, 5); layer3.initCards(new int[]{5, 6, 7}); layers.add(layer3); } /** * 刷新全局“頂層可用卡牌”緩存。 */ private void refreshTopMostCardsCache() { allTopMostCardsCache new ArrayList(); for (Layer layer : layers) { allTopMostCardsCache.addAll(layer.getAvailableCards()); } } /** * 處理鼠標(biāo)點(diǎn)擊邏輯。 * param clickX 鼠標(biāo)點(diǎn)擊X坐標(biāo) * param clickY 鼠標(biāo)點(diǎn)擊Y坐標(biāo) */ public void onMouseClick(int clickX, int clickY) { if (gameState ! GameState.PLAYING) { return; // 游戲已結(jié)束點(diǎn)擊無效 } // 1. 檢查是否點(diǎn)擊了可用的地圖卡牌 for (Card card : allTopMostCardsCache) { if (card.isPointInCard(clickX, clickY)) { // 選中這張卡牌將其移入待消除槽 moveCardToSlot(card); refreshTopMostCardsCache(); // 移動(dòng)后可用卡牌發(fā)生變化 checkGameState(); // 檢查游戲是否結(jié)束 return; } } // 2. 可選檢查是否點(diǎn)擊了槽內(nèi)卡牌進(jìn)行撤銷等操作此處略過。 } private void moveCardToSlot(Card card) { if (slotCards.size() SLOT_CAPACITY) { // 槽已滿理論上不應(yīng)發(fā)生因?yàn)橹皶?huì)判斷游戲狀態(tài) return; } card.setSelected(true); // 計(jì)算卡牌在槽中的新位置 int slotIndex slotCards.size(); card.setX(SLOT_X slotIndex * (Card.CARD_WIDTH 10)); card.setY(SLOT_Y); slotCards.add(card); // 嘗試消除 tryEliminateInSlot(); } /** * 檢查并消除槽內(nèi)滿足條件的卡牌。 */ private void tryEliminateInSlot() { // 按卡牌類型分組 MapInteger, ListCard typeMap new HashMap(); for (Card card : slotCards) { typeMap.computeIfAbsent(card.getType(), k - new ArrayList()).add(card); } // 查找是否有某種類型的卡牌數(shù)量3 for (ListCard cardList : typeMap.values()) { if (cardList.size() 3) { // 消除最早進(jìn)入槽的三張或任意三張 for (int i 0; i 3; i) { Card toRemove cardList.get(i); toRemove.setEliminated(true); slotCards.remove(toRemove); } // 消除后需要重新排列槽內(nèi)剩余卡牌的位置 rearrangeSlotCards(); // 消除后可能又產(chǎn)生新的可消除組合遞歸檢查一次簡(jiǎn)單處理 tryEliminateInSlot(); break; } } } /** * 重新排列槽內(nèi)卡牌的位置。 */ private void rearrangeSlotCards() { for (int i 0; i slotCards.size(); i) { Card card slotCards.get(i); card.setX(SLOT_X i * (Card.CARD_WIDTH 10)); card.setY(SLOT_Y); } } /** * 檢查游戲狀態(tài)勝利或失敗。 */ private void checkGameState() { // 勝利條件所有圖層中未消除且未選中的卡牌數(shù)量為0 boolean allCardsCleared true; for (Layer layer : layers) { for (Card card : layer.getCards()) { if (!card.isEliminated() !card.isSelected()) { allCardsCleared false; break; } } if (!allCardsCleared) break; } if (allCardsCleared) { gameState GameState.WIN; return; } // 失敗條件槽已滿且無法消除 if (slotCards.size() SLOT_CAPACITY) { // 檢查當(dāng)前槽內(nèi)是否有可消除的組合 MapInteger, Integer typeCount new HashMap(); for (Card card : slotCards) { typeCount.put(card.getType(), typeCount.getOrDefault(card.getType(), 0) 1); } boolean canEliminate typeCount.values().stream().anyMatch(count - count 3); if (!canEliminate) { gameState GameState.FAIL; } } } /** * 繪制整個(gè)游戲畫面。 */ public void paint(Graphics g) { // 1. 繪制所有圖層 for (Layer layer : layers) { layer.paint(g, allTopMostCardsCache); } // 2. 繪制待消除槽背景和卡牌 Image slotBg ImageUtil.getImage(slot_bg.png); g.drawImage(slotBg, SLOT_X - 10, SLOT_Y - 10, SLOT_CAPACITY * (Card.CARD_WIDTH 10) 20, Card.CARD_HEIGHT 20, null); for (Card card : slotCards) { card.paint(g, false); // 槽內(nèi)卡牌不高亮 } // 3. 繪制游戲狀態(tài)勝利/失敗 if (gameState GameState.WIN) { Image winImage ImageUtil.getImage(win.png); g.drawImage(winImage, 300, 200, null); } else if (gameState GameState.FAIL) { Image failImage ImageUtil.getImage(fail.png); g.drawImage(failImage, 300, 200, null); } // 4. 可選繪制一些提示信息如剩余卡牌數(shù)、槽位數(shù)量等 g.setColor(Color.BLACK); g.drawString(槽位: slotCards.size() / SLOT_CAPACITY, SLOT_X, SLOT_Y - 20); } }現(xiàn)在回到GameFrame類補(bǔ)全initGame方法中對(duì)GameService的初始化。// 在 GameFrame.initGame() 方法中 private void initGame() { this.gameService new GameService(); this.gameService.startGame(); }4. 運(yùn)行驗(yàn)證與交互測(cè)試完成以上代碼后運(yùn)行AppMain類游戲窗口應(yīng)該能正常顯示。4.1 預(yù)期運(yùn)行結(jié)果窗口成功彈出標(biāo)題為“羊了個(gè)羊 - Java版”。窗口內(nèi)部分為上中下三個(gè)區(qū)域上層顯示三層錯(cuò)落堆疊的卡牌部分卡牌被遮擋。最上層的可點(diǎn)擊卡牌應(yīng)有半透明綠色高亮提示。中層空白區(qū)域。下層顯示一個(gè)卡槽區(qū)域初始為空旁邊有“槽位0/7”的提示。鼠標(biāo)點(diǎn)擊高亮的卡牌該卡牌會(huì)從原位置消失并出現(xiàn)在下方的卡槽中同時(shí)原位置下方被遮擋的卡牌可能會(huì)變?yōu)楦吡量捎?。?dāng)卡槽中集齊三張相同圖案的卡牌時(shí)這三張卡牌會(huì)立即消失騰出槽位。當(dāng)所有地圖上的卡牌都被移入卡槽并消除后屏幕中央顯示勝利圖片。當(dāng)卡槽被7張無法消除的卡牌填滿時(shí)屏幕中央顯示失敗圖片。4.2 關(guān)鍵交互測(cè)試點(diǎn)測(cè)試動(dòng)作預(yù)期結(jié)果驗(yàn)證目的點(diǎn)擊非高亮被遮擋卡牌無反應(yīng)驗(yàn)證可用性判斷邏輯isCardAvailable點(diǎn)擊高亮卡牌卡牌移入槽位原位置可能釋放新卡牌驗(yàn)證onMouseClick和moveCardToSlot槽內(nèi)湊齊三張同圖案卡牌三張卡牌立即消除槽位重排驗(yàn)證tryEliminateInSlot邏輯消除后槽內(nèi)又湊齊三張?jiān)俅斡|發(fā)消除驗(yàn)證消除邏輯的遞歸或循環(huán)檢查消除所有地圖卡牌顯示勝利畫面驗(yàn)證checkGameState的勝利條件槽滿且無法消除顯示失敗畫面驗(yàn)證checkGameState的失敗條件如果測(cè)試結(jié)果與預(yù)期不符需要根據(jù)現(xiàn)象進(jìn)行排查。5. 常見問題排查與調(diào)試技巧在開發(fā)過程中你可能會(huì)遇到以下典型問題。5.1 圖片加載失敗窗口空白或拋出異?，F(xiàn)象運(yùn)行后窗口一片空白或控制臺(tái)拋出RuntimeException: 圖片資源未找到。排查檢查res文件夾是否位于項(xiàng)目的根目錄與src同級(jí)而不是src內(nèi)部。檢查圖片文件名包括后綴是否與代碼中ImageUtil.getImage(“card_bg.png”)的字符串完全一致注意大小寫。在 IDE 中右鍵點(diǎn)擊res文件夾確保其被標(biāo)記為Resources Root或類似資源目錄。在ImageUtil類的getImage方法開始處添加System.out.println(“Loading: ” imageName);查看程序試圖加載的路徑。5.2 點(diǎn)擊卡牌無反應(yīng)現(xiàn)象鼠標(biāo)點(diǎn)擊卡牌但卡牌沒有移動(dòng)到槽中。排查坐標(biāo)判斷問題在Card.isPointInCard方法中添加日志打印卡牌區(qū)域和點(diǎn)擊坐標(biāo)確認(rèn)判斷邏輯是否正確。注意AWT的坐標(biāo)系原點(diǎn)在窗口左上角?？捎每ㄅ凭彺嫖锤麓_保在moveCardToSlot方法中移走卡牌后調(diào)用了refreshTopMostCardsCache()。事件未觸發(fā)在GameFrame.mouseReleased方法中打日志確認(rèn)鼠標(biāo)事件被正確捕獲并傳遞給了gameService.onMouseClick?？ㄅ茽顟B(tài)錯(cuò)誤檢查被點(diǎn)擊的卡牌isEliminated()和isSelected()狀態(tài)是否均為false。5.3 卡牌消除邏輯異?，F(xiàn)象槽內(nèi)已有三張相同卡牌但未消除或消除后卡牌位置錯(cuò)亂。排查類型匹配確認(rèn)Card的type屬性在初始化時(shí)被正確賦值并且在tryEliminateInSlot中分組邏輯正確。消除條件檢查tryEliminateInSlot方法中if (cardList.size() 3)這行代碼是否被執(zhí)行。列表修改異常在tryEliminateInSlot中直接從slotCards列表中remove元素可能會(huì)導(dǎo)致ConcurrentModificationException或遍歷錯(cuò)亂。我們的代碼通過先找到待刪除元素再統(tǒng)一操作來避免但需仔細(xì)檢查循環(huán)和刪除的邏輯。重排坐標(biāo)消除后務(wù)必調(diào)用rearrangeSlotCards()為槽內(nèi)剩余的卡牌重新計(jì)算坐標(biāo)。5.4 游戲狀態(tài)判斷錯(cuò)誤現(xiàn)象卡牌已清空但未勝利或槽未滿卻判定失敗。排查勝利條件遍歷在checkGameState的勝利條件檢查中確保遍歷了所有圖層 (layers) 的所有卡牌并且判斷條件是“未消除且未選中”。失敗條件判斷時(shí)機(jī)失敗判斷應(yīng)在每次卡牌入槽moveCardToSlot后立即進(jìn)行。檢查onMouseClick中調(diào)用checkGameState()的時(shí)機(jī)。狀態(tài)變量更新確保gameState在勝利或失敗時(shí)被正確設(shè)置為GameState.WIN或GameState.FAIL并且在paint方法中根據(jù)此狀態(tài)繪制不同圖片。5.5 界面閃爍或卡頓現(xiàn)象畫面更新時(shí)有明顯閃爍。解決我們已經(jīng)使用了雙緩沖技術(shù)在GameFrame.paint中創(chuàng)建offScreenImage。如果仍有閃爍嘗試將重繪線程的睡眠時(shí)間Thread.sleep(30)適當(dāng)調(diào)大如改為Thread.sleep(50)20FPS以減少不必要的重繪。確保所有繪圖操作都在paint方法或其調(diào)用的方法中完成避免在事件線程中直接進(jìn)行耗時(shí)繪圖。6. 項(xiàng)目?jī)?yōu)化與擴(kuò)展方向完成基礎(chǔ)版本后可以從以下幾個(gè)方面進(jìn)行優(yōu)化和擴(kuò)展使其更完善、更像一個(gè)真正的項(xiàng)目。6.1 功能增強(qiáng)撤銷功能在GameService中維護(hù)一個(gè)操作棧記錄每次移動(dòng)卡牌的操作卡牌ID從哪層移到槽。實(shí)現(xiàn)一個(gè)撤銷按鈕或快捷鍵將槽中最后一張卡牌移回原處。洗牌/提示功能當(dāng)玩家無牌可消時(shí)提供“洗牌”功能隨機(jī)重排當(dāng)前可用卡牌位置或“提示”功能高亮一組可消除的卡牌。關(guān)卡與難度設(shè)計(jì)多個(gè)關(guān)卡每關(guān)使用不同的圖層布局、卡牌類型和槽容量。將關(guān)卡數(shù)據(jù)圖層定義、卡牌類型配置在外部文件如JSON中。音效與動(dòng)畫為卡牌移動(dòng)、消除、勝利失敗事件添加音效。使用Timer或線程實(shí)現(xiàn)卡牌移動(dòng)的平滑動(dòng)畫而不是瞬間跳轉(zhuǎn)。6.2 代碼結(jié)構(gòu)優(yōu)化引入 MVC 模式當(dāng)前GameService承擔(dān)了部分控制器Controller和模型Model的角色?？梢赃M(jìn)一步明確分離GameModel純數(shù)據(jù)模型管理Layer,Card,slotCards,gameState。GameController處理鼠標(biāo)事件調(diào)用GameModel的方法修改狀態(tài)。GameView即GameFrame負(fù)責(zé)根據(jù)GameModel的數(shù)據(jù)進(jìn)行渲染。配置化將窗口大小、卡牌尺寸、槽容量、圖層定義等硬編碼參數(shù)提取到config.properties配置文件中。日志記錄使用SLF4JLogback替換System.out.println方便記錄游戲運(yùn)行狀態(tài)和調(diào)試信息。6.3 部署與打包生成可執(zhí)行 JAR在 IDE 中或使用 Maven/Gradle 將項(xiàng)目及其依賴本例無外部依賴打包成一個(gè)可執(zhí)行的 JAR 文件。確保res資源文件夾被打包進(jìn) JAR。制作安裝程序使用Launch4j或JPackageJDK 14將 JAR 打包成 Windows 的.exe或 macOS 的.app方便分發(fā)。這個(gè)項(xiàng)目麻雀雖小五臟俱全。通過它你實(shí)踐了 Java GUI 編程、事件處理、自定義繪圖、雙緩沖、集合操作、遞歸邏輯判斷等多個(gè)核心知識(shí)點(diǎn)。更重要的是你體驗(yàn)了一個(gè)完整小項(xiàng)目從設(shè)計(jì)、編碼、調(diào)試到優(yōu)化的全過程這份經(jīng)驗(yàn)遠(yuǎn)比單純學(xué)習(xí)語法更有價(jià)值。接下來你可以嘗試實(shí)現(xiàn)上述的某個(gè)擴(kuò)展功能或者用同樣的思路去實(shí)現(xiàn)另一個(gè)經(jīng)典小游戲如“連連看”或“掃雷”來鞏固你的技能。