簡介面向C課程設計、期末大作業(yè)與畢業(yè)設計場景的高分項目資源基于C與Qt實現(xiàn)經(jīng)典俄羅斯方塊游戲。代碼注釋完整、模塊劃分清晰包含可運行的Qt工程與項目文檔下載解壓并配置Qt環(huán)境后即可運行適合直接提交或在此基礎上二次開發(fā)。資源共42個文件涵蓋頭文件與源文件、Qt界面相關的ui與json配置、動態(tài)鏈接庫與靜態(tài)庫以及docx項目手冊和txt說明壓縮包約11.87MB。文件層次覆蓋游戲邏輯、界面繪制、構(gòu)建配置與文檔說明其中ui與json負責界面及配置lib、dll等支撐編譯運行docx手冊用于快速了解設計與提交說明。已有316人學習或下載。該項目的突出價值在于以98分獲導師認可完整展示了俄羅斯方塊從游戲狀態(tài)管理、方塊生成與旋轉(zhuǎn)、碰撞檢測、消行計分到界面繪制的全過程。關鍵函數(shù)與算法均配有注釋新手也能跟著代碼梳理實現(xiàn)思路項目文檔則補充設計說明與運行方式為答辯和匯報提供支撐。源碼目錄和文檔命名清晰便于按需查閱對應模塊既可作為學習C與Qt協(xié)同開發(fā)的脫手范例也是課程設計或畢業(yè)設計可快速上手的高分參考模板。1. 選俄羅斯方塊作為 C/QT 大作業(yè)為什么它是高分題庫里的常青樹俄羅斯方塊在 C 課程大作業(yè)里屬于“看著不新鮮、做完不虧”的類型規(guī)則全世界都知道但要把七種方塊、旋轉(zhuǎn)、碰撞、消行、計分、等級加速這些要素寫干凈恰好覆蓋了類設計、數(shù)組與內(nèi)存管理、QT 的信號槽與事件機制。比學生管理系統(tǒng)多一層實時交互比射擊游戲少一堆素材和物理計算工作量通常兩周內(nèi)可控代碼量能控制在 1500 行左右評閱老師也容易看出你的設計思路。這個選題適合既要保成績又想沖優(yōu)的同學代碼不難但設計空間足夠撐起一份高分項目的課程文檔。下面按我自己的落地順序講先數(shù)據(jù)結(jié)構(gòu)再界面渲染再游戲邏輯最后把文檔和答辯一起收尾。2. 先把數(shù)據(jù)結(jié)構(gòu)立住方塊表示、旋轉(zhuǎn)矩陣與碰撞檢測怎么寫2.1 三個類拆清楚Tetromino、Board、GameController 各自只干一件事寫俄羅斯方塊最容易翻車的寫法是把所有變量和函數(shù)全部塞進 MainWindow界面邏輯和游戲邏輯揉成一團。課程設計階段我一般會拆三個純邏輯類加一個界面類分工如下Tetromino描述當前方塊的形狀、朝向和棋盤坐標提供旋轉(zhuǎn)和取格子的接口。Board負責棋盤內(nèi)部用一個二維數(shù)組 grid[ROW][COL] 記錄已落定方塊的顏色編號提供碰撞檢測、落定合并和消行接口。GameController持有 Board、當前方塊、下一塊、分數(shù)和等級實現(xiàn)下落、左右移動、旋轉(zhuǎn)、硬降和游戲狀態(tài)切換。這個拆分在評閱時非常加分因為老師幾乎必問“如果我要加一種五格方塊你要改哪些地方”答案是只改 TetrominoBoard 和 GameController 都不動。這就是分層設計的現(xiàn)場演示比答辯時背概念管用得多。先看 Tetromino 的頭文件// tetromino.h —— 七種方塊統(tǒng)一用 4x4 模板存儲 #ifndef TETROMINO_H #define TETROMINO_H #include QVector #include QPoint class Tetromino { public: enum Shape { NONE, I, O, T, S, Z, J, L }; explicit Tetromino(Shape s); void rotate(); // 順時針旋轉(zhuǎn) 90 度 void setPos(int x, int y); // 方塊左上角在棋盤上的坐標 QPoint pos() const { return m_pos; } QVectorQPoint cells() const; // 返回模板中非空格子的相對坐標 Shape shape() const { return m_shape; } private: Shape m_shape; int m_matrix[4][4]; // 1 表示該格有方塊 QPoint m_pos; }; #endif這里用 QVector 和 QPoint 是因為后面要直接把這些坐標映射到 QPainter 繪制省一次轉(zhuǎn)換。如果你想讓文檔更偏“純 C”換成 std::arraystd::arrayint,4,4 和自帶的坐標結(jié)構(gòu)也一樣不影響其他類。構(gòu)造時每種形狀自己填充 m_matrix比如 T 字塊在模板中的形態(tài)是 (1,0)、(0,1)、(1,1)、(2,1) 四個格子為 1。用 4x4 而不是直接存坐標數(shù)組是為了把旋轉(zhuǎn)變成純矩陣運算不引入額外算法。2.2 用 4×4 模板表示七種方塊旋轉(zhuǎn)就是“轉(zhuǎn)置 水平翻轉(zhuǎn)”矩陣旋轉(zhuǎn)是這里最值得寫在文檔里的細節(jié)。順時針旋轉(zhuǎn) 90 度等價于先對矩陣做轉(zhuǎn)置再把每一行左右翻轉(zhuǎn)寫成代碼只有四行// tetromino.cpp —— 旋轉(zhuǎn)矩陣的核心邏輯 #include tetromino.h #include cstring void Tetromino::rotate() { if (m_shape O) return; // 正方形的 O 方塊旋轉(zhuǎn)后不變直接跳過 int temp[4][4]; std::memset(temp, 0, sizeof(temp)); for (int i 0; i 4; i) { for (int j 0; j 4; j) { temp[i][3 - j] m_matrix[j][i]; // 轉(zhuǎn)置后水平翻轉(zhuǎn) } } std::memcpy(m_matrix, temp, sizeof(m_matrix)); }新手最容易寫錯的是下標寫成 temp[3 - i][j] 或者 temp[j][i] 不帶翻轉(zhuǎn)結(jié)果旋轉(zhuǎn)幾次后圖形發(fā)生漂移。驗證方法很簡單拿一個 I 方塊在紙上畫一遍旋轉(zhuǎn)后應該是橫躺狀態(tài)而且旋轉(zhuǎn)中心不偏移。這也是用 4x4 而不是 3x3 的原因3x3 矩陣放不下水平的 I 方塊4 格強行表示會造成旋轉(zhuǎn)中心偏移S、Z 方塊轉(zhuǎn)起來也會有錯位感。O 方塊在構(gòu)造函數(shù)里就把矩陣填成 2x2 的田字放在 4x4 的左上角旋轉(zhuǎn)時直接 return避免無意義的矩陣拷貝。文檔里寫清楚這個特判評閱老師會認為你考慮過邊界情況。2.3 碰撞檢測的“先放后查”策略為什么比逐格判斷更不容易出 bug碰撞檢測是整個游戲正確性的地基。我見過不少實現(xiàn)給每個方塊維護四條邊移動時逐邊判斷是否出界旋轉(zhuǎn)后再重新計算邊界表。這個思路的問題是方塊狀態(tài)一變邊界數(shù)據(jù)就要同步多維護一份狀態(tài)就多一個翻車點。在 10 列 20 行的固定棋盤上最簡單可靠的是“先放后查”把方塊挪到目標位置然后統(tǒng)一檢查越界和重疊。// board.cpp —— 碰撞檢測先嘗試放置沖突則拒絕該動作 bool Board::canPlace(const Tetromino t, int newX, int newY) const { const QVectorQPoint cells t.cells(); for (const QPoint c : cells) { int x newX c.x(); int y newY c.y(); if (x 0 || x COLS) return false; // 超出左右邊界 if (y ROWS) return false; // 超出底部 if (y 0 m_grid[y][x] ! 0) return false; // 與已固定方塊重疊 // 注意y 0 時允許存在 } return true; }m_grid 的行索引是 y列索引是 x存的不是布爾值而是顏色編號這樣后面繪制和消行都能復用。canPlace 只做查詢不修改數(shù)據(jù)左移、右移、下落、旋轉(zhuǎn)、硬降全部調(diào)它判定邏輯只有一份。y 0 放行是關鍵細節(jié)方塊生成時有一部分可能還在棋盤上方之外如果把 y 0 也判成碰撞開局第一塊就放不下來。這個細節(jié)容易被忽略我在測試時踩過屏幕上方明明還有空間方塊卻卡在半空。有了 canPlace 之后落定和合并的邏輯就順了。GameController 的 tick 是整個游戲的主循環(huán)核心// gamecontroller.cpp —— 每次定時器觸發(fā)執(zhí)行一次下落 void GameController::tick() { if (m_state ! PLAYING) return; if (canMove(0, 1)) { m_current.setPos(m_current.pos().x(), m_current.pos().y() 1); } else { merge(); // 當前方塊寫入棋盤 int n board.clearLines(); if (n 0) linesCleared(n); spawnNext(); // 從預覽隊列取出下一塊 if (!canPlace(m_current, m_current.pos().x(), m_current.pos().y())) gameOver(); // 新方塊放不下判負 } }canMove 內(nèi)部就是調(diào) board.canPlace而 spawnNext 里同樣用 canPlace 判斷游戲是否結(jié)束也就是“生成時預判”的結(jié)束方式。這樣整個下落流程的所有動作都收口到同一個碰撞函數(shù)邏輯只有一條路徑排查問題時只需要看 canPlace 一個函數(shù)。3. 用 QT Widgets 把棋盤畫出來QPainter、QTimer 與鍵盤事件三步走3.1 工程文件與源碼清單一個 QWidget 項目需要哪幾個文件界面層我用 QMainWindow 作為主窗口中央放一個自繪的 GameWidget右側(cè)放信息面板。新建項目時在 Qt Creator 里直接選 QWidget Application會自動生成 .pro 或 CMakeLists。這里建議裝 Qt 5.15.2 LTS而不是追最新版原因很現(xiàn)實老師機器上的 QT 版本大概率是 5.x網(wǎng)上能搜到的答案也集中在 5.15遇到問題好查。課程設計不推薦用 VSCode 配置 C 環(huán)境來寫 QTCMake 加套件配置會吃掉你一大半時間老老實實用 Qt Creator 帶 qmake 的模板五分鐘就能把空項目跑起來。源碼文件清單大致如下文件職責關鍵成員main.cpp創(chuàng)建 QApplication 和主窗口無gamewidget.h/.cpp繪制棋盤、接收按鍵、驅(qū)動定時器paintEvent、keyPressEvent、QTimerboard.h/.cpp棋盤數(shù)據(jù)、碰撞檢測、消行grid、canPlace、clearLinestetromino.h/.cpp方塊形狀與旋轉(zhuǎn)matrix、rotate、cellsgamecontroller.h/.cpp游戲規(guī)則、分數(shù)、等級、狀態(tài)tick、move、rotate、hardDropGameWidget 頭文件的骨架長這樣// gamewidget.h —— 界面層只做三件事繪制、收按鍵、驅(qū)動定時器 #ifndef GAMEWIDGET_H #define GAMEWIDGET_H #include QWidget #include QTimer #include gamecontroller.h class GameWidget : public QWidget { Q_OBJECT public: explicit GameWidget(QWidget *parent nullptr); void start(); // 開始游戲并啟動定時器 protected: void paintEvent(QPaintEvent *e) override; void keyPressEvent(QKeyEvent *e) override; private: GameController m_game; QTimer m_timer; }; #endif注意 m_timer 這里作為成員對象而不是指針省去手動 delete。QTimer 的 timeout 信號用 lambda 槽連接可以少在頭文件里聲明一個槽函數(shù)課程代碼也更緊湊。3.2 paintEvent 繪制棋盤與方塊像素坐標換算的 CELL_SIZE 參數(shù)繪制只寫在 paintEvent 里這是 QT 的規(guī)矩不要在別的地方直接畫。每次游戲狀態(tài)變化后調(diào)用 update()QT 會合并重繪請求并在合適的時機觸發(fā) paintEvent。繪制順序是背景、已固定方塊、當前活動方塊一層層往上疊。// gamewidget.cpp —— paintEvent 是唯一繪制入口 void GameWidget::paintEvent(QPaintEvent *) { QPainter painter(this); const int CELL 30; // 每格 30x30 像素 const int ROWS 20, COLS 10; // 1. 畫背景 painter.fillRect(0, 0, COLS * CELL, ROWS * CELL, QColor(0x1e, 0x1e, 0x1e)); // 2. 畫已固定方塊 for (int r 0; r ROWS; r) { for (int c 0; c COLS; c) { int id m_game.board().cell(r, c); if (id ! 0) { painter.fillRect(c * CELL, r * CELL, CELL - 1, CELL - 1, m_game.colorOf(id)); } } } // 3. 畫當前活動方塊 Tetromino cur m_game.current(); QColor clr m_game.colorOf(cur.shape()); for (const QPoint p : cur.cells()) { int px (cur.pos().x() p.x()) * CELL; int py (cur.pos().y() p.y()) * CELL; if (py 0) // 頂部以上的部分不畫 painter.fillRect(px, py, CELL - 1, CELL - 1, clr); } }CELL_SIZE 的選取是個體驗問題10 列 20 行的棋盤用 30 像素畫布就是 300x600右側(cè)再留 150 像素放信息和下一個方塊預覽主窗口固定成 480x640 比較協(xié)調(diào)。用 24 會讓窗口顯得局促演示時分數(shù)看不清用 40 又太大筆記本屏幕上放不下。格子填充減 1 像素是為了自然露出背景色當格線不額外畫線的省力做法比 drawLine 畫 11 條豎線簡單且不會出現(xiàn) 1 像素錯位。3.3 QTimer 驅(qū)動下落與 keyPressEvent 響應按鍵主循環(huán)怎么寫游戲主循環(huán)不用 while(true)那會卡死 QT 的事件循環(huán)。正確姿勢是 QTimer 周期性觸發(fā)每次觸發(fā)做一次下落邏輯然后調(diào)用 update() 請求重繪。// gamewidget.cpp —— 啟動游戲、連接定時器和鍵盤 void GameWidget::start() { setFocusPolicy(Qt::StrongFocus); // 必須設置否則鍵盤事件進不來 connect(m_timer, QTimer::timeout, this, [this]() { m_game.tick(); update(); }); m_timer.start(m_game.interval()); // interval 由等級計算得出 } void GameWidget::keyPressEvent(QKeyEvent *e) { switch (e-key()) { case Qt::Key_Left: m_game.move(-1); break; case Qt::Key_Right: m_game.move(1); break; case Qt::Key_Down: m_game.move(0, 1); break; case Qt::Key_Up: m_game.rotate(); break; case Qt::Key_Space: m_game.hardDrop(); break; case Qt::Key_P: m_game.togglePause(); break; default: QWidget::keyPressEvent(e); return; } update(); // 每次按鍵后立即重繪 }兩個細節(jié)容易踩坑。第一setFocusPolicy 不寫的話鍵盤事件永遠進不了這個控件程序跑起來鼠標點哪都沒反應這是 QT 新手最常見的黑匣子之一。第二每次按鍵后都要調(diào)用 update()否則邏輯已經(jīng)變了但畫面還停在上一幀。定時器那邊也一樣tick 之后緊跟 update()缺了它你會看到方塊只在消行那一瞬間跳變其他操作都像沒響應。QTimer 的 interval 可以在運行中修改等級上升后直接 m_timer.start(newInterval) 就會重設定時周期。不要在 tick 里用 QThread::sleep 或 std::this_thread::sleep_for 模擬減速那是把整個界面線程睡死窗口拖動都會卡成幻燈片。3.4 右側(cè)信息面板與預覽區(qū)布局代碼比 Qt Designer 拖拽更快信息面板只有三個標簽加一個預覽畫布用代碼布局比開 Qt Designer 來回拖快也更好控制。預覽區(qū)可以復用 GameWidget 的繪制思路單獨做一個 PreviewWidget只畫下一塊// previewwidget.cpp —— 只畫一個方塊的迷你畫布 void PreviewWidget::paintEvent(QPaintEvent *) { QPainter painter(this); painter.fillRect(rect(), QColor(0x12, 0x12, 0x12)); Tetromino next m_game.next(); QColor clr m_game.colorOf(next.shape()); for (const QPoint p : next.cells()) { int px (p.x() 1) * 20; // 4x4 模板在 4*20 的畫布上居中 int py (p.y() 1) * 20; painter.fillRect(px, py, 18, 18, clr); } }PreviewWidget 同樣要暴露一個 updatePreview() 接口在 GameController 的 spawnNext 之后由外部調(diào)用。這個類看起來多余但它把“預覽下一塊”從主繪制里拆了出去新增一個“未來五塊預覽”時不用動 GameWidget。主窗口的布局用 QHBoxLayout 放 GameWidget 和右側(cè) QVBoxLayout右側(cè)依次放分數(shù)標簽、等級標簽、PreviewWidget最后 addStretch 把控件頂?shù)缴戏健４翱?setFixedSize 禁止拉伸免得用戶把窗口拉變形后棋盤比例失調(diào)。4. 游戲邏輯細節(jié)消行判定、計分規(guī)則與等級加速的聯(lián)動4.1 從底部逐行掃描消行memcpy 整行下移的寫法和 y 陷阱消行邏輯寫在 Board 里常見做法是每次方塊落定后從最后一行往上掃遇到滿行就把它上面的所有行整體下移一行。代碼本身很短坑都在循環(huán)下標上// board.cpp —— 消行并返回消掉的函數(shù) int Board::clearLines() { int lines 0; for (int y ROWS - 1; y 0; --y) { bool full true; for (int x 0; x COLS; x) { if (m_grid[y][x] 0) { full false; break; } } if (!full) continue; // 當前行滿上方所有行下移一行頂部補空行 for (int yy y; yy 0; --yy) { std::memcpy(m_grid[yy], m_grid[yy - 1], sizeof(m_grid[0])); } std::memset(m_grid[0], 0, sizeof(m_grid[0])); y; // 下移后當前行換成了新內(nèi)容需要重新檢查 lines; } return lines; }那個 y 是容易看漏的細節(jié)。整行下移后原來的 y 行現(xiàn)在裝的是 y-1 行的內(nèi)容這一行可能也是滿的所以循環(huán)要回退一格重新檢查。漏掉 y 的后果是連續(xù)兩行同時滿時只消掉下面的那一行上面的滿行殘留測試同學常把這當成“消行 bug”其實是循環(huán)下標沒回退。從底部往上掃比從頂部往底部掃省事因為消掉底行后上方的行位置不變不需要額外處理。用 memcpy 整行拷貝比自己寫 for 循環(huán)逐列賦值快而且代碼少但要注意 sizeof(m_grid[0]) 必須等于一行數(shù)組的字節(jié)數(shù)這里因為 m_grid 是 int grid[ROWS][COLS]sizeof(m_grid[0]) 是 COLS 個 int 的大小正好對應。4.2 計分與等級行列數(shù)與下落速度 interval 怎么聯(lián)動計分規(guī)則直接參照經(jīng)典任天堂規(guī)則寫在文檔里既規(guī)范又好編碼。規(guī)則如下消行數(shù)基礎分倍率1100當前等級2300當前等級3500當前等級4800當前等級也就是單次消兩行得 300 乘以當前等級而不是 100 加 100這個區(qū)分讓玩家更愿意堆四行一起消也是答辯時可以講的一個設計點。等級按總消行數(shù)每 10 行升一級下落間隔從 500 毫秒起步每級減 30 毫秒最低 80 毫秒防止后期快到人眼跟不上// gamecontroller.cpp —— 計分和等級聯(lián)動 void GameController::linesCleared(int n) { static const int scoreTable[5] {0, 100, 300, 500, 800}; m_score scoreTable[n] * m_level; m_lines n; if (m_lines / 10 m_level - 1) { m_level; m_interval std::max(80, 500 - (m_level - 1) * 30); emit intervalChanged(m_interval); // 通知界面層重設定時器 } }等級變化后GameWidget 要響應 intervalChanged 信號并重新 m_timer.start。用信號而不是界面層輪詢 m_game.interval()是為了讓邏輯層不感知界面保持分層。很多同學在這里犯的錯是把 interval 寫死等級升了速度不變答辯被問“加速在哪”時答不上來。4.3 下一個方塊預覽用簡單成員還是隊列兩種寫法的取舍預告下一塊是俄羅斯方塊的標配實現(xiàn)上有兩種常見做法。一是 GameController 持有一個 Tetromino m_next落定后 current m_nextm_next 再隨機生成新形狀。二是維護一個 QQueue 每次從隊頭取一塊隊尾補新塊。課程設計階段我推薦第一種理由有三個代碼少一半不需要處理隊列為空的情況隨機性對一個課設來說完全夠用。只有當你計劃做“7-bag”隨機算法把七種方塊各放一次打亂依次出塊時才需要第二種配合一個固定大小的數(shù)組。生成隨機形狀時用 QT 的 QRandomGenerator::global()-bounded(7) 或者 C11 的 std::mt19937這兩種都是正經(jīng)的均勻分布隨機數(shù)能寫進文檔。退一步用 rand() % 7 雖然也能跑但答辯被問到隨機數(shù)質(zhì)量時不太好解釋。spawnNext 的代碼// gamecontroller.cpp —— 從預覽區(qū)取出新方塊 void GameController::spawnNext() { m_current m_next; m_next Tetromino(static_castTetromino::Shape( QRandomGenerator::global()-bounded(7) 1)); m_current.setPos(SPAWN_X, SPAWN_Y); // 例如 (3, 0)居中偏上 }SPAWN_X 取 (COLS - 4) / 2 附近讓方塊大致居中SPAWN_Y 取 0 或 -1 都可以如果取 -1方塊會從棋盤頂部上方一格滑下來視覺上更順滑且恰好利用 canPlace 對 y 0 放行的特性。4.4 游戲結(jié)束判定放在哪兩個時機生成時預判還是落定后檢查游戲結(jié)束的判定時機有兩個選擇。一個是在落定合并后看棋盤是否超出頂部另一個是在生成新方塊時看初始位置是否放得下。我推薦后者也就是 spawnNext 之后立刻檢查// gamecontroller.cpp —— 新方塊無法落位則結(jié)束 void GameController::spawnNext() { // ... 設置 m_current 和 m_next ... if (!board.canPlace(m_current, m_current.pos().x(), m_current.pos().y())) { m_state OVER; emit gameOver(m_score); } }這比落定后再檢查更早暴露問題而且不需要額外維護“最高行溢出”這種狀態(tài)。界面層收到 gameOver 信號后彈一個 QMessageBox顯示分數(shù)并詢問是否重開。注意 gameOver 信號發(fā)出后定時器要 stop否則 tick 還會繼續(xù)跑在 OVER 狀態(tài)下雖然 tick 里有一層防護但停止定時器能省 CPU 也讓邏輯更干凈。忘記停止定時器你會看到結(jié)束后方塊還在往下落這是很多人忽略的收尾細節(jié)。5. 高分項目避坑指南QT 環(huán)境、焦點事件與重繪卡頓的經(jīng)典事故5.1 平臺插件報錯qt.qpa.plugin 找不到 windows 或 linuxfb 平臺插件現(xiàn)象程序編譯通過雙擊 exe 或命令行運行時直接崩潰終端輸出一行類似 qt.qpa.plugin: Could not find the Qt platform plugin windows in 的報錯后面還跟著“已終止”或段錯誤。原因QT 程序運行時需要從 plugins 目錄加載平臺插件可執(zhí)行文件拷到別的路徑后找不到同目錄下的 platforms 文件夾或者系統(tǒng) PATH 里指向的 QT 安裝路徑和編譯時用的不是同一個。解決課程設計階段在 Qt Creator 里直接運行就行不要折騰綠色版。需要提交獨立可執(zhí)行文件時用 QT 自帶的 windeployqt 工具把依賴 DLL 和 plugins 目錄拷到 exe 旁邊一句命令搞定。Linux 下如果報的是 linuxfb 找不到多半是嵌入式交叉編譯環(huán)境的QT_QPA_PLATFORM設了不被支持的平臺檢查環(huán)境變量即可。成熟的老師看課設都在你筆記本上跑不用追求單文件綠色版那反而容易翻車。5.2 版本混用報錯cannot mix incompatible qt library (version ex50601)現(xiàn)象編譯鏈接全過運行時彈窗或終端報 Fatal: cannot mix incompatible Qt library (version 0x50601) with this library version 0x50a01程序直接退出。這種報錯在裝了多個 QT 版本的機器上非常常見。原因鏈接器找到的是 5.6.1 的頭文件和庫而運行時加載的 DLL 是 5.10.1 的版本對不上。通常是系統(tǒng)的 QT 路徑、Qt Creator 配置的 Kit、以及編譯器的鏈接搜索路徑三者不一致導致的比如你之前手動裝過某個舊版 QT環(huán)境變量里殘留 qmake 路徑VSCode 配置 C 環(huán)境時又指到了另一邊。解決打開 Qt Creator 的“工具 - 選項 - Kits - Qt Versions”把用不到的版本路徑全部移除只保留 5.15.2 的 qmake。項目構(gòu)建目錄建議刪掉重新 qmake 一次避免 Makefile 里殘留舊路徑。如果你確實在 VSCode 里配過 C 環(huán)境那個 QT 路徑和 Qt Creator 通常不是同一套兩者不要交叉使用。我的習慣是課程設計期間只開 Qt Creator見到這個報錯第一時間查 Kit而不是去重裝 QT。5.3 按鍵沒反應setFocusPolicy 與焦點丟失的那點事現(xiàn)象界面能正常顯示鼠標點按鈕有響應方向鍵、空格鍵怎么按都沒反應游戲像死了一樣。原因QWidget 默認不接受鍵盤焦點keyPressEvent 只有在控件獲得焦點時才會被調(diào)用。窗口剛顯示時焦點可能落在某個按鈕或者沒有焦點控件上按鍵事件被分發(fā)給焦點對象而不是你的 GameWidget。解決在 GameWidget 構(gòu)造函數(shù)里加一行 setFocusPolicy(Qt::StrongFocus)讓這個控件可以用鍵盤和 Tab 獲取焦點。如果界面上有 QPushButton 或 QLineEdit點擊它們之后焦點會轉(zhuǎn)移此時繼續(xù)按方向鍵就失靈。處理辦法是對按鈕調(diào)用 setFocusPolicy(Qt::NoFocus)或者重寫整個主窗口的 eventFilter 統(tǒng)一攔截鍵盤事件再轉(zhuǎn)給 GameWidget后者更徹底但課設代碼里用 NoFocus 就夠。這個坑一流出現(xiàn)查代碼半小時查不出來其實就是少寫了一行。5.4 界面閃爍與掉幀別在 timer 里 new QPainter統(tǒng)一用 update()現(xiàn)象方塊移動時窗口閃爍或者移動一頓一頓不跟手消行瞬間尤其明顯。原因把繪制代碼寫在了定時器回調(diào)或者按鍵處理函數(shù)里在事件循環(huán)外直接往窗口上畫東西系統(tǒng)在下一幀重繪時又把你的繪制覆蓋掉造成閃爍。另一種情況是邏輯層用了 sleep 或大量拷貝導致事件循環(huán)卡頓update() 延遲到很晚才合并觸發(fā)。解決所有繪制統(tǒng)一收進 paintEvent邏輯變化只調(diào) update()。QT 會合并同一次事件循環(huán)里的多個 update()所以按鍵加定時器連續(xù)觸發(fā) update 不會造成額外開銷不用擔心性能。不要在 tick 里做耗時的全棋盤掃描消行時只處理有變化的部分或至少把 clearLines 的實現(xiàn)保持為 O(ROWS*COLS)這個量級完全扛得住。如果 QPainter 開了抗鋸齒后覺得卡把 painter.setRenderHint(QPainter::Antialiasing) 關掉這里畫的是矩形抗鋸齒不僅沒用還拖慢速度。5.5 崩潰在 delete 上QT 父子對象機制與棧對象不要混用現(xiàn)象游戲正常運行退出程序時崩潰報 double free 或析構(gòu)相關斷言有時候是 CtrlC 結(jié)束沒反應關窗口才炸。原因QT 的 QObject 父子機制規(guī)定父對象析構(gòu)時會自動銷毀所有子對象。你把一個控件 new 出來并且傳了 parent之后又手動 delete 它就造成二次釋放。反過來在棧上創(chuàng)建了 QWidget 還給別人當了 parent棧對象析構(gòu)時父對象可能已經(jīng)先析構(gòu)了觸發(fā)懸垂指針。解決凡是構(gòu)造函數(shù)里傳了 parent 的對象一律不手動 delete交給父對象統(tǒng)一管理。如果需要提前銷毀用 deleteLater()它會在事件循環(huán)安全點執(zhí)行刪除。GameWidget 里的 QTimer m_timer 是成員對象不是 new 出來的析構(gòu)時隨 GameWidget 一起銷毀不涉及這個問題。這一條寫進文檔的“遇到的問題”章節(jié)算是展示你理解 QT 內(nèi)存管理比抄一段智能指針的八股答得實在。6. 項目文檔與答辯把“高分項目”的分數(shù)落在紙面上6.1 一份課程設計文檔的骨架需求分析、概要設計、測試記錄怎么寫源代碼寫得再好文檔拿不出手還是會被扣分。課程設計文檔的標準結(jié)構(gòu)是需求分析、概要設計、詳細設計、測試報告、心得五部分其中概要設計和測試報告占的分數(shù)最多。概要設計里放一張手繪的類圖就夠畫出 Tetromino、Board、GameController、GameWidget 四個類的關系標注關鍵的 public 接口比復制十頁代碼有用。測試報告別只寫“測試通過”把幾個典型場景列出來方塊到邊界能否停止、旋轉(zhuǎn)后碰墻能否拒絕、連續(xù)消四行得分是否正確、游戲結(jié)束后按鍵是否無響應每條配一張運行截圖。截圖記得把分數(shù)和等級一起截進去評閱老師會看分數(shù)是否和消行數(shù)對得上。6.2 答辯講這三個亮點分層架構(gòu)、碰撞收口、擴展性答辯時不用面面俱到講三個點足夠。第一講分層界面類不碰游戲數(shù)據(jù)控制器不碰繪制代碼老師問“加功能要改哪里”時你能明確指出改哪個類。第二講碰撞檢測收口到 canPlace 的取舍所有移動、旋轉(zhuǎn)、硬降共用同一個判定函數(shù)而不是每個動作各寫一堆邊界判斷。第三講擴展性加新方塊只改 Tetromino加 7-bag 隨機只用動 spawnNext加存檔只要在 GameController 里序列化分數(shù)和棋盤。這三句話比背概念更能讓老師相信項目是你自己寫的。我當年做這個題翻車就翻在 update() 上邏輯全對但界面紋絲不動查了整整一個晚上最后發(fā)現(xiàn)只是忘了在按鍵后請求重繪。“改代碼不如先懷疑重繪沒觸發(fā)”這道坎邁過去之后我對 QT 的繪圖機制算是徹底通了。這個項目的完整實現(xiàn)值得你親手敲一遍別直接抄源碼自己把 canPlace 和 clearLines 寫對一次收獲比跑通十遍別人的代碼都大。希望幫到你。本文還有配套的精品資源點擊獲取