# 五子棋

**Repository Path**: flame-come-here/gomoku

## Basic Information

- **Project Name**: 五子棋
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-18
- **Last Updated**: 2025-12-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 五子棋

#### 介绍
基于面向过程和面向对象两种思想实现的五子棋游戏，使用Python的tkinter库进行图形界面开发。

## 软件架构

### 面向过程实现（main.py）
- **编程方式**：采用面向过程的编程思想，通过函数组织代码逻辑
- **主要模块**：
  - 棋盘初始化与绘制模块
  - 落子逻辑模块
  - 胜负判断模块
  - 游戏流程控制模块
- **技术特点**：
  - 使用函数封装各个功能点
  - 共享全局变量维护游戏状态
  - 简单直观的控制流程

### 面向对象实现（main_oop.py）
- **编程方式**：采用面向对象的编程思想，通过类组织代码逻辑
- **主要类**：
  - `GomokuGame`：游戏核心类，封装了所有游戏逻辑
- **主要方法**：
  - 构造方法：初始化游戏界面和参数
  - 棋盘绘制方法
  - 落子方法
  - 胜负判断方法
  - 事件处理方法
- **技术特点**：
  - 封装性：将数据和操作封装在类中
  - 模块化：通过方法划分不同功能
  - 便于扩展和维护

### 带悔棋功能的面向过程实现（main_with_undo.py）
- **编程方式**：采用面向过程的编程思想，通过函数组织代码逻辑
- **主要模块**：
  - 棋盘初始化与绘制模块
  - 落子逻辑模块
  - 胜负判断模块
  - 悔棋功能模块
  - 游戏流程控制模块
- **技术特点**：
  - 在基本版本基础上添加了悔棋功能
  - 使用历史记录列表记录每一步操作
  - 提供了悔棋按钮界面元素

### 带悔棋功能的面向对象实现（main_oop_with_undo.py）
- **编程方式**：采用面向对象的编程思想，通过类组织代码逻辑
- **主要类**：
  - `GomokuGame`：游戏核心类，封装了所有游戏逻辑
- **主要方法**：
  - 构造方法：初始化游戏界面和参数
  - 棋盘绘制方法
  - 落子方法
  - 胜负判断方法
  - 悔棋功能方法
  - 事件处理方法
  - 按钮创建方法
- **技术特点**：
  - 在基本版本基础上添加了悔棋功能
  - 使用历史记录列表记录每一步操作
  - 提供了悔棋按钮界面元素

## 安装教程

1. 确保您的计算机已经安装了 Python 3.6 或更高版本
2. 下载本项目的所有文件到本地目录
3. 无需额外安装依赖库，使用 Python 标准库即可运行

## 使用说明

### 运行游戏

1. 打开终端或命令提示符
2. 进入项目所在目录

### 基本版本（不带悔棋功能）
- 运行面向过程版本：`python main.py`
- 或运行面向对象版本：`python main_oop.py`

### 增强版本（带悔棋功能）
- 运行面向过程版本：`python main_with_undo.py`
- 或运行面向对象版本：`python main_oop_with_undo.py`

### 游戏规则

1. 黑方先行，双方轮流落子
2. 点击棋盘上的交叉点放置棋子
3. 率先在横、竖、斜方向上连成5个子的一方获胜

### 悔棋功能

1. 在带悔棋功能的版本中，点击"悔棋"按钮可以撤销上一步操作
2. 悔棋后，棋盘状态会恢复到上一步，玩家回合也会相应切换
3. 如果没有可以悔棋的步骤（游戏刚开始时），会弹出提示信息

### 游戏结束

游戏结束后，会弹出提示框显示获胜方

#### 参与贡献

1.  Fork 本仓库
2.  新建 Feat_xxx 分支
3.  提交代码
4.  新建 Pull Request


#### 特技

1.  使用 Readme\_XXX.md 来支持不同的语言，例如 Readme\_en.md, Readme\_zh.md
2.  Gitee 官方博客 [blog.gitee.com](https://blog.gitee.com)
3.  你可以 [https://gitee.com/explore](https://gitee.com/explore) 这个地址来了解 Gitee 上的优秀开源项目
4.  [GVP](https://gitee.com/gvp) 全称是 Gitee 最有价值开源项目，是综合评定出的优秀开源项目
5.  Gitee 官方提供的使用手册 [https://gitee.com/help](https://gitee.com/help)
6.  Gitee 封面人物是一档用来展示 Gitee 会员风采的栏目 [https://gitee.com/gitee-stars/](https://gitee.com/gitee-stars/)