在實(shí)際 Java 學(xué)習(xí)路徑中從掌握基礎(chǔ)語(yǔ)法到完成一個(gè)能寫(xiě)在簡(jiǎn)歷上的綜合項(xiàng)目中間往往存在一個(gè)明顯的斷層。很多同學(xué)學(xué)完了 JavaSE 的核心知識(shí)卻不知道如何將這些零散的知識(shí)點(diǎn)如集合、多線程、IO、GUI串聯(lián)起來(lái)構(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)編程和圖形界面開(kāi)發(fā)的能力。本文將帶你從零開(kāi)始使用純 JavaSE 技術(shù)棧不依賴任何游戲引擎完全通過(guò)手動(dòng)編碼來(lái)實(shí)現(xiàn)一個(gè)簡(jiǎn)化版的“羊了個(gè)羊”游戲。我們將從游戲的核心數(shù)據(jù)模型設(shè)計(jì)入手逐步完成圖形窗口的繪制、鼠標(biāo)事件的響應(yīng)、游戲規(guī)則的判斷直到最終形成一個(gè)可運(yùn)行、可交互的完整項(xiàng)目。這個(gè)過(guò)程不僅是為了得到一個(gè)游戲更重要的是理解一個(gè)桌面應(yīng)用從數(shù)據(jù)到視圖再到控制器的完整開(kāi)發(fā)流程以及如何組織代碼、調(diào)試界面和解決開(kāi)發(fā)中遇到的具體問(wèn)題。完成本項(xiàng)目后你將獲得一個(gè)可用于課程設(shè)計(jì)、畢業(yè)設(shè)計(jì)或豐富個(gè)人簡(jiǎn)歷的實(shí)質(zhì)性作品并對(duì) Java 圖形界面編程有更深入的理解。1. 理解項(xiàng)目架構(gòu)與核心模型設(shè)計(jì)在動(dòng)手寫(xiě)代碼之前必須先厘清游戲的核心規(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ì)被消除騰出槽位?？捎眯耘袛嘀挥刑幱谧钌蠈忧椅幢黄渌ㄅ普趽醯目ㄅ萍纯梢?jiàn)卡牌才能被點(diǎn)擊選中。游戲狀態(tài)當(dāng)所有卡牌被消除游戲勝利當(dāng)“待消除槽”被填滿且無(wú)法構(gòu)成消除時(shí)游戲失敗?；谶@些規(guī)則我們需要設(shè)計(jì)幾個(gè)核心的類模型來(lái)承載游戲狀態(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)、判斷某張卡牌在本層是否“可用”即上方無(wú)其他卡牌遮擋、繪制本層所有卡牌。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 庫(kù)無(wú)需任何外部 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ǔ)框架搭建在開(kāi)始實(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文件夾。在代碼中我們將通過(guò)類加載器來(lái)讀取這些資源。2.2 實(shí)現(xiàn)工具類與主窗口框架首先實(shí)現(xiàn)一個(gè)簡(jiǎn)單的圖片加載工具類避免在業(yè)務(wù)代碼中重復(fù)編寫(xiě)資源加載邏輯。// 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); } } }接下來(lái)創(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(); } /** * 雙緩沖繪制先在離線圖像上畫(huà)再一次性畫(huà)到窗口上避免閃爍。 */ 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)在我們來(lái)填充之前設(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開(kāi)始 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); } } } /** * 判斷指定卡牌在本層中是否是“可用”的即上方無(wú)遮擋。 * 簡(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; // 跳過(guò)自身、已消除、已選中的卡牌 } // 如果其他卡牌的區(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ò)開(kāi) 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)擊無(wú)效 } // 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)行撤銷等操作此處略過(guò)。 } 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; } // 失敗條件槽已滿且無(wú)法消除 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è)游戲畫(huà)面。 */ 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張無(wú)法消除的卡牌填滿時(shí)屏幕中央顯示失敗圖片。4.2 關(guān)鍵交互測(cè)試點(diǎn)測(cè)試動(dòng)作預(yù)期結(jié)果驗(yàn)證目的點(diǎn)擊非高亮被遮擋卡牌無(wú)反應(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)檢查消除所有地圖卡牌顯示勝利畫(huà)面驗(yàn)證checkGameState的勝利條件槽滿且無(wú)法消除顯示失敗畫(huà)面驗(yàn)證checkGameState的失敗條件如果測(cè)試結(jié)果與預(yù)期不符需要根據(jù)現(xiàn)象進(jìn)行排查。5. 常見(jiàn)問(wèn)題排查與調(diào)試技巧在開(kāi)發(fā)過(guò)程中你可能會(huì)遇到以下典型問(wèn)題。5.1 圖片加載失敗窗口空白或拋出異?，F(xiàn)象運(yùn)行后窗口一片空白或控制臺(tái)拋出RuntimeException: 圖片資源未找到。排查檢查res文件夾是否位于項(xiàng)目的根目錄與src同級(jí)而不是src內(nèi)部。檢查圖片文件名包括后綴是否與代碼中ImageUtil.getImage(“card_bg.png”)的字符串完全一致注意大小寫(xiě)。在 IDE 中右鍵點(diǎn)擊res文件夾確保其被標(biāo)記為Resources Root或類似資源目錄。在ImageUtil類的getImage方法開(kāi)始處添加System.out.println(“Loading: ” imageName);查看程序試圖加載的路徑。5.2 點(diǎn)擊卡牌無(wú)反應(yīng)現(xiàn)象鼠標(biāo)點(diǎn)擊卡牌但卡牌沒(méi)有移動(dòng)到槽中。排查坐標(biāo)判斷問(wèn)題在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。卡牌狀態(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ò)亂。我們的代碼通過(guò)先找到待刪除元素再統(tǒng)一操作來(lái)避免但需仔細(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)象畫(huà)面更新時(shí)有明顯閃爍。解決我們已經(jīng)使用了雙緩沖技術(shù)在GameFrame.paint中創(chuàng)建offScreenImage。如果仍有閃爍嘗試將重繪線程的睡眠時(shí)間Thread.sleep(30)適當(dāng)調(diào)大如改為T(mén)hread.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)玩家無(wú)牌可消時(shí)提供“洗牌”功能隨機(jī)重排當(dāng)前可用卡牌位置或“提示”功能高亮一組可消除的卡牌。關(guān)卡與難度設(shè)計(jì)多個(gè)關(guān)卡每關(guān)使用不同的圖層布局、卡牌類型和槽容量。將關(guān)卡數(shù)據(jù)圖層定義、卡牌類型配置在外部文件如JSON中。音效與動(dòng)畫(huà)為卡牌移動(dòng)、消除、勝利失敗事件添加音效。使用Timer或線程實(shí)現(xiàn)卡牌移動(dòng)的平滑動(dòng)畫(huà)而不是瞬間跳轉(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)目及其依賴本例無(wú)外部依賴打包成一個(gè)可執(zhí)行的 JAR 文件。確保res資源文件夾被打包進(jìn) JAR。制作安裝程序使用Launch4j或JPackageJDK 14將 JAR 打包成 Windows 的.exe或 macOS 的.app方便分發(fā)。這個(gè)項(xiàng)目麻雀雖小五臟俱全。通過(guò)它你實(shí)踐了 Java GUI 編程、事件處理、自定義繪圖、雙緩沖、集合操作、遞歸邏輯判斷等多個(gè)核心知識(shí)點(diǎn)。更重要的是你體驗(yàn)了一個(gè)完整小項(xiàng)目從設(shè)計(jì)、編碼、調(diào)試到優(yōu)化的全過(guò)程這份經(jīng)驗(yàn)遠(yuǎn)比單純學(xué)習(xí)語(yǔ)法更有價(jià)值。接下來(lái)你可以嘗試實(shí)現(xiàn)上述的某個(gè)擴(kuò)展功能或者用同樣的思路去實(shí)現(xiàn)另一個(gè)經(jīng)典小游戲如“連連看”或“掃雷”來(lái)鞏固你的技能。