仓颉语言实现的象棋小游戏:基于仓颉语言的命令行中国象棋对弈程序

可用于本地双人进行中国象棋对战,体验完整象棋规则。该项目实现七种棋子走法,支持将军、将死、困毙判定,通过Unicode符号绘制棋盘,红方棋子ANSI红色高亮,提供坐标标注。【此简介由AI生成】

Branch1Tags0

中国象棋 (Xiangqi)

基于仓颉编程语言 (Cangjie) 开发的命令行中国象棋对弈程序,支持完整的象棋规则,适合本地双人对战。

目录

功能特性

棋子走法

完整实现了七种棋子的走法规则:

棋子 说明
帅/将 九宫格内一步直行,四方向移动
仕/士 九宫格内一步斜行
相/象 田字对角移动,受阻于"塞象眼"
马 日字对角移动,受阻于"蹩马脚"
车 直线任意距离移动
炮 直线移动,翻山吃子(需隔一枚棋子)
兵/卒 未过河只能前进,过河后可左右移动(不能后退)

规则判定

  • 将军检测 — 实时检测己方将/帅是否处于被攻击状态,包括飞将规则(将帅同列且无遮挡)
  • 将死判定 — 被将军且无任何走法可以应将
  • 困毙判定 — 未被将军但无合法走法可走,视为输棋
  • 走法合法性 — 自动过滤走后己方仍被将军的非法走法

棋盘显示

  • 棋盘使用 Unicode 符号绘制,包含楚河汉界分隔线
  • 红方棋子以 ANSI 红色高亮显示
  • 行号 0~9 + 列号 a~i 坐标标注

游戏界面示例

    a   b   c   d   e   f   g   h   i
0   车  马  象  士  將  士  象  马  车 
1   +  +  +  +  +  +  +  +  + 
2   +  砲  +  +  +  +  +  砲  + 
3   卒  +  卒  +  卒  +  卒  +  卒 
4   +  +  +  +  +  +  +  +  + 
    ────── 楚河           漢界 ──────
5   +  +  +  +  +  +  +  +  + 
6   兵  +  兵  +  兵  +  兵  +  兵 
7   +  炮  +  +  +  +  +  炮  + 
8   +  +  +  +  +  +  +  +  + 
9   車  馬  相  仕  帥  仕  相  馬  車 

紅方 走棋,輸入移動(例如 a0a1):

环境要求

  • 仓颉编译器 (cjc) >= 1.0.5
  • 仓颉包管理器 (cjpm)

快速开始

# 克隆仓库
git clone https://gitcode.com/ZUT_Cangjie/T_zy_428.git
cd T_zy_428

# 编译并运行
cjpm run

游戏规则

胜负条件

  1. 将死 — 一方被将军且无法应将,对方获胜
  2. 困毙 — 一方无子可动(所有棋子均无合法走法),对方获胜

特殊规则

  • 飞将 — 将帅不可在同列且无棋子遮挡,否则视为被将军
  • 九宫 — 将/帅和仕/士的活动范围限定在己方九宫格内
  • 己方半场 — 相/象不可过河
  • 塞象眼 — 相/象移动路径的田字中心有棋子时不能移动
  • 蹩马脚 — 马移动路径的日字邻点有棋子时不能移动
  • 炮架 — 炮吃子时,目标前必须恰好有一枚棋子作为炮架

操作说明

走法输入格式

使用 4 个字符表示一步棋,格式为:起始列 起始行 目标列 目标行

列: a b c d e f g h i  (从左至右)
行: 0 1 2 3 4 5 6 7 8 9  (从上至下,黑方底线为 0,红方底线为 9)

示例

输入 含义
b2e2 黑炮从 b2 移至 e2(平炮)
a0a1 黑车从 a0 前进至 a1
b7e7 红炮从 b7 移至 e7
c6c5 红兵从 c6 前进至 c5

对局流程

  1. 程序启动后显示初始棋盘
  2. 红方执先手,输入走法后回车确认
  3. 程序自动判定走法合法性,不合法则提示重新输入
  4. 每次走棋后自动检测将军、将死、困毙状态
  5. 一方获胜后程序结束

项目结构

src/
├── main.cj      # 主程序:游戏主循环、棋盘渲染、输入解析
├── types.cj     # 类型定义:Side 阵营、PieceType 棋子种类、Piece/PiecePosition 结构体
├── board.cj     # 棋盘模块:Board 类、棋子初始化、移动、查询、拷贝
└── engine.cj    # 引擎模块:走法生成、将军检测、合法性判定、将死/困毙判定

设计概述

走法验证流程

用户输入 → parseMove() 解析坐标
         → isLegalMove() 验证
            ├── 检查是否为己方棋子
            ├── 生成伪合法走法(仅棋子规则)
            ├── 模拟走子后的棋盘局面
            └── 检查己方将帅是否仍被将军
         → 通过则执行,否则提示重新输入

核心类型

  • Side — 枚举类型,Red / Black,标记红方与黑方
  • PieceType — 枚举类型,表示 King Advisor Elephant Horse Rook Cannon Pawn 七种棋子
  • Piece — 结构体,包含 pieceType 和 side 两个字段
  • Position — 结构体,表示棋盘上的行列位置,提供 isValid() 方法校验越界
  • Board — 类,封装 10×9 二维棋盘,提供棋子增删查改及局面拷贝

许可

MIT License

Introduction

可用于本地双人进行中国象棋对战,体验完整象棋规则。该项目实现七种棋子走法,支持将军、将死、困毙判定,通过Unicode符号绘制棋盘,红方棋子ANSI红色高亮,提供坐标标注。【此简介由AI生成】

Customize your domain