您现在的位置：程式碼之家 >> 編程語言 > >> C語言 >> C++ >> 關於C++

C++ 模塊化實戰：拆分文件提升可維護性與復用性

編輯：關於C++

為什麼要拆分文件？

單文件寫法在項目小時尚可接受，但隨著代碼增長，萬行級 main.cpp 會讓人「頭暈目眩」。將功能相關的聲明/定義拆分到獨立文件，帶來三大收益：

可維護性：修改撲克邏輯只改 poker.c，改玩家邏輯只改 player.c。
可復用性：他人開發撲克遊戲時，直接複製 poker.c/.h 即可複用「洗牌、發牌、排序」完整功能。
團隊協作：不同模塊由不同人員並行開發，減少合併衝突。

實戰：撲克遊戲三文件拆分

文件劃分原則

文件	職責	核心內容
`poker.c`	撲克核心邏輯	`Card` 結構、花色枚舉、`CARD_COUNT`、構造/洗牌/排序/比較/獲取名字函數、原始牌組數組
`player.c`	玩家邏輯	`Player` 結構、發牌函數 `dispatchCards`
`main.c`	程序入口與流程控制	`main()`、初始化、調用洗牌/發牌/排序/打印、資源釋放

關鍵技術點：`.c` 文件直接 `#include`？

初學者常嘗試在 main.c 中 #include "poker.c"，但直接編譯會報「重複定義」錯誤。原因在於：

#include 本質是文本展開，將 poker.c 內容複製到 main.c。
若 poker.c 同時參與編譯（生成 poker.o），鏈接時會發現同一函數/全局變量有兩個定義。

解決方案：在構建系統（如 Qt Creator、CMake、VS）中將 poker.c、player.c 從編譯目標中移除（取消勾選），僅保留 main.c 參與編譯。此時 .c 文件內容經 #include 合併進 main.c，形成單一編譯單元，無重複定義。

⚠️ 注意：只從專案移除編譯引用，不要刪除物理文件，否則 #include 找不到源文件。

代碼展示

poker.c — 撲克核心


#include 
#include 
#include 

#define CARD_COUNT 54
enum Suit { heart, spade, diamond, club, joker1, joker2 };

typedef struct Card {
    int value;      // 1-15
    enum Suit suit;
} Card;

typedef int (*COMPARE)(Card*, Card*);

Card pokers[CARD_COUNT]; // 原始牌組

void initOnePack() { /* ... 構造 54 張牌 ... */ }
Card** shuffle(const Card* src) { /* ... 洗牌演算法 ... */ }
void sort(Card** cards, int n, COMPARE cmp) { /* ... 冒泡/快排 ... */ }
int compare1(Card* a, Card* b) { /* 升序 */ }
int compare2(Card* a, Card* b) { /* 降序 */ }
char* getCardName(const Card* card) { /* 動態分配並返回 "紅桃A" 等字符串，調用者需 free */ }

player.c — 玩家與發牌


typedef struct Player {
    char name[64];
    Card** cards;     // 指向原始牌組元素的指針數組，節省內存
    int cardsCount;
} Player;

void dispatchCards(Player** players, int playerCount, const Card** shuffledCards) {
    int perPlayer = CARD_COUNT / playerCount + 1; // +1 保證容量
    for (int i = 0; i < playerCount; ++i)
        players[i]->cards = malloc(perPlayer * sizeof(Card*));
    
    for (int i = 0; i < CARD_COUNT; ++i) {
        Player* cur = players[i % playerCount];
        cur->cards[cur->cardsCount++] = shuffledCards[i];
    }
}

main.c — 程序入口


#include 
#include 
#include 
#include "poker.c"
#include "player.c"

int main() {
    initOnePack();
    Card** shuffled = shuffle(pokers);
    
    Player p1 = {"隔壁老王", NULL, 0};
    Player p2 = {"小明", NULL, 0};
    Player p3 = {"田中龜孫", NULL, 0};
    Player* players[] = {&p1, &p2, &p3};
    
    dispatchCards(players, 3, (const Card**)shuffled);
    free(shuffled); // 洗牌臨時數組用完即釋放
    
    for (int i = 0; i < 3; ++i) {
        printf("%s: ", players[i]->name);
        sort(players[i]->cards, players[i]->cardsCount, compare1);
        for (int j = 0; j < players[i]->cardsCount; ++j) {
            char* name = getCardName(players[i]->cards[j]);
            printf("%s ", name);
            free(name); // 歸還 getCardName 分配的內存
        }
        putchar('\n');
        free(players[i]->cards); // 釋放指針數組
    }
    return 0;
}