C语言实现三子井字棋：从逻辑到多文件工程结构

三子棋的游戏逻辑基础

三子棋（Tic-Tac-Toe），又称井字棋或九宫格游戏。其核心规则是在一个 3×3 的网格中，两名玩家轮流放置棋子（通常以 'X' 和 'O' 表示）。当任意一方的三个棋子在水平、垂直或对角线方向连成一线时，该方获胜；若棋盘填满且无人获胜，则判定为平局。

要实现这一游戏，首先需要将复杂的逻辑拆解为清晰的执行步骤。一个标准的命令行版本应当包含以下生命周期：

1. 菜单管理：提供“开始游戏”与“退出”选项。
2. 环境准备：创建并初始化 3×3 的字符型二维数组作为棋盘，默认填充空格。
3. 显示反馈：实时渲染当前棋盘状态，使视觉效果更接近真实桌面。
4. 交互落子：处理玩家输入的行列坐标，并进行边界检查与占用判断。
5. 智能决策：模拟电脑（AI）利用随机数生成器在空位落子。
6. 状态检测：每次落子后扫描全盘，判定输赢、平局或继续游戏。

核心模块实现细节

第一步：建立游戏控制菜单

主函数负责程序的入口与循环控制。利用 do-while 结构确保菜单至少呈现一次，并通过 switch-case 语句分流用户指令。

// test.c - 入口文件片段
int main()
{
    int input = 0;
    // 随机数种子初始化，基于系统时间
    srand((unsigned int)time(NULL));
    
    do {
        menu();
        printf("请输入选择: >");
        scanf("%d", &input);
        switch (input)
        {
            case 1:
                game(arr, ROW, COL); // 启动一局游戏
                break;
            case 0:
                printf("已退出游戏\n");
                break;
            default:
                printf("输入无效，请重新输入\n");
                break;
        }
    } while (input);
    return 0;
}

第二步：定义棋盘常量

为了便于后期扩展（例如改为五子棋），推荐使用宏定义来指定行列维度，而非直接硬编码数字。

#define ROW 3
#define COL 3

第三步：初始化与渲染棋盘

游戏开始前，必须调用 InitBoard 将数组元素全部置为空格 ' '。打印棋盘时需兼顾表格线，形成美观的网格结构。

// 棋盘绘制示意
//  %c | %c | %c 
// ---|---|--- 
//  %c | %c | %c 

第四步：处理玩家输入落子

玩家落子是人机交互的核心难点。逻辑上需要满足两个约束条件：
1. 坐标范围必须在 [1, 3] 之间。
2. 目标位置不能已被其他棋子占据。

在内部存储时，由于数组索引从 0 开始，因此实际存入 arr[x-1][y-1] 的位置。如果输入非法或被占用，应提示用户重新输入，直至成功。

第五步：电脑随机落子

对于简易版AI，采用伪随机方式即可。调用 rand() % 3 产生 0~2 之间的索引值。同样需要检查该随机生成的位置是否为空，若是占用状态则进行重试（或生成新的随机数），直到找到空位为止。

第六步：胜负判定算法

判定胜负需要遍历三种形态：行、列和对角线。返回结果需区分四种状态：
- '*'：玩家胜利
- '#'：电脑胜利
- 'Q'：平局（棋盘已满）
- 'C'：游戏继续（棋盘未满且无胜者）

判定逻辑示例：

char IsWin(char arr[ROW][COL], int row, int col) {
    // 1. 检查是否平局
    if (Is_Full(arr, row, col) == 1) return 'Q';

    // 2. 遍历检查行与列
    for (int i = 0; i < ROW; i++) {
        // 检查行
        if (arr[i][0] != ' ' && arr[i][0] == arr[i][1] && arr[i][1] == arr[i][2]) return arr[i][0];
        // 检查列
        if (arr[0][i] != ' ' && arr[0][i] == arr[1][i] && arr[1][i] == arr[2][i]) return arr[0][i];
    }
    // 3. 检查对角线
    if (arr[0][0] != ' ' && arr[0][0] == arr[1][1] && arr[1][1] == arr[2][2]) return arr[0][0];
    if (arr[0][2] != ' ' && arr[0][2] == arr[1][1] && arr[1][1] == arr[2][0]) return arr[0][2];

    return 'C'; // 继续
}

工程化重构：多文件编写模式

随着功能增加，将所有代码塞入一个文件会导致难以维护。在大型项目开发中，我们习惯将声明与实现分离，典型的结构分为三部分：

• game.h：存放宏定义、头文件引用以及所有函数的原型声明。
• game.c：存放具体功能的实现代码（如初始化、落子、判输赢逻辑）。
• test.c：仅保留 main 函数，负责调度游戏流程。

优势说明：

1. 封装性：其他开发者只需包含 game.h 即可调用游戏功能，无需知晓底层算法。
2. 解耦：修改游戏规则仅需调整 game.c，而不影响 test.c 的主流程。
3. 编译效率：只有修改过的源文件需要重新编译，适合长周期项目。

以下是多文件架构下的核心头文件声明示例：

#ifndef __GAME_H__
#define __GAME_H__

#include <stdio.h>
#include <stdlib.h>
#include <time.h>

#define ROW 3
#define COL 3

// 函数声明
void InitBoard(char board[ROW][COL], int row, int col);
void DisplayBoard(char board[ROW][COL], int row, int col);
void PlayerMove(char board[ROW][COL], int row, int col);
void ComputerMove(char board[ROW][COL], int row, int col);
char IsWin(char board[ROW][COL], int row, int col);

#endif