1. 先搞清楚“纯代码”国际象棋到底在玩什么看到“国际象棋但是纯代码”这个标题很多人的第一反应可能是这不就是个用代码实现的国际象棋游戏吗有什么特别的如果你也这么想那可能就错过了它最核心的玩法和挑战。这个项目真正的价值不在于“用代码画出一个棋盘”而在于用代码的逻辑和规则去模拟、推演甚至重构整个国际象棋的博弈过程。它考验的不是你的美术功底而是你的逻辑抽象能力、算法设计能力和对规则理解的深度。简单来说它解决的是“如何让计算机理解并执行国际象棋规则”的问题。这听起来基础但落地时从棋盘状态表示、棋子移动规则、特殊走法如王车易位、吃过路兵的判断到胜负判定将军、将死、逼和每一步都需要严谨的代码逻辑。对于开发者尤其是算法、游戏逻辑或AI入门的学习者这是一个绝佳的练手项目。它能让你深刻体会到将一套复杂的、充满例外情况的现实规则转化为无歧义的、可执行的代码是一个多么需要耐心和细心的过程。所以这篇文章不是教你画一个漂亮的棋盘界面而是带你从零开始用代码的思维搭建一套完整的、可运行的国际象棋规则引擎。我会按照实际开发的顺序从核心数据结构的定义到基础移动规则的实现再到复杂特殊规则的判断最后完成一个可以自己和自己下棋的“大脑”。即使你之前没做过游戏开发跟着这个思路走一遍也能对状态机、规则引擎有更扎实的理解。2. 环境与核心数据结构一切从“棋盘”开始在动手写任何移动逻辑之前我们必须先定义好棋盘和棋子的表示方式。这是整个项目的基石设计得好后续逻辑会清晰很多设计得不好后面会处处碰壁。我建议从最朴素、最直接的方式开始用一个8x8的二维数组来表示棋盘。数组的每个元素代表一个格子里面存放一个值用来表示这个格子上是什么棋子或者为空。2.1 如何表示棋子和棋盘一种常见且清晰的做法是使用字符或简单的枚举。例如# 使用字符表示棋子大写为白方小写为黑方 EMPTY . WHITE_PAWN P BLACK_PAWN p WHITE_ROOK R BLACK_ROOK r WHITE_KNIGHT N # 注意K已经被国王用了骑士通常用NKnight BLACK_KNIGHT n WHITE_BISHOP B BLACK_BISHOP b WHITE_QUEEN Q BLACK_QUEEN q WHITE_KING K BLACK_KING k # 初始化一个空棋盘 board [[EMPTY for _ in range(8)] for _ in range(8)]这样board[0][0]就可以是‘r’黑方左车board[6][4]可以是‘P’白方e2兵。这种表示法非常直观调试时一眼就能看出棋盘状态。除了棋盘状态我们还需要记录一些游戏状态信息这些是规则判断的关键当前轮到哪一方走棋side_to_move‘white’或‘black’。王车易位权利白王是否可以进行短易位white_kingside_castle、长易位white_queenside_castle黑方同理。一旦王或相应的车移动过这个权利就永久丧失。吃过路兵的目标格en_passant_target记录上一步对方兵前进两格后身后那个可以被“吃过路兵”的格子坐标。如果不存在则为None。半回合计数halfmove_clock用于50步和棋规则从上次吃子或兵移动开始计数。完整回合数fullmove_number从1开始白方走棋后计数增加。把这些状态封装在一个类或结构体里会非常方便。这就是我们游戏的“内存”。2.2 坐标系统的选择这里有一个细节需要注意数组索引和棋盘坐标的映射关系。国际象棋棋盘有8行rank1-8和8列filea-h。在程序中我们通常用(row, col)来表示一个格子。我个人的习惯是让row 0对应棋盘的第1行白方底线row 7对应第8行黑方底线col 0对应a列col 7对应h列。这样初始状态下白方王‘K’就在(0, 4)也就是e1格。这个映射关系一定要在开始时就确定下来并在所有函数中保持一致否则移动逻辑会彻底混乱。你可以写两个辅助函数来进行转换方便调试def square_to_coords(square): # 例如 ‘e4’ - (4, 4) file_char, rank_char square[0], square[1] col ord(file_char) - ord(a) row 8 - int(rank_char) return row, col def coords_to_square(row, col): # 例如 (4, 4) - ‘e4’ file_char chr(col ord(a)) rank_char str(8 - row) return file_char rank_char3. 实现基础移动规则让棋子“动起来”有了棋盘表示接下来就是重头戏为每种棋子定义它的合法移动规则。这里的“合法”指的是基于棋子自身走法规则的合法暂时先不考虑是否会把己方王暴露在将军下那是下一步要做的。我们的目标是写一个函数比如get_pseudo_legal_moves(board, position)输入棋盘和某个格子的坐标返回这个格子上的棋子所有可能走到的目标格列表伪合法移动。3.1 兵Pawn的移动最复杂的简单棋子兵的规则最多是第一个难点。它涉及向前走一格前提是目标格为空。起始位置向前走两格前提是起始格在初始行白兵在row6黑兵在row1且路径上两格都为空。斜向吃子向左前或右前移动一格前提是目标格有对方棋子。吃过路兵一种特殊的吃子方式。如果对方兵从上一步移动了两格正好停在我方兵相邻的侧方那么我方兵可以“斜向”移动到对方兵身后的那个空格并吃掉它。这需要利用我们之前记录的en_passant_target状态。代码逻辑上需要根据棋子颜色白或黑来决定“向前”是row增加还是减少。这里很容易出错建议单独为兵写一个函数把颜色作为参数。3.2 车Rook、象Bishop、后Queen的移动射线扫描这三种棋子的移动都是沿着直线车横竖象斜线后横竖斜直到被阻挡。 实现他们的通用方法是“射线扫描”。 以白车为例从它当前位置出发向四个方向上、下、左、右依次探索如果目标格为空则是一个合法移动继续向该方向看下一格。如果目标格有对方棋子则这是一个“吃子”移动将其加入列表然后停止该方向的扫描。如果目标格有己方棋子则不能移动停止该方向的扫描。象和后同理只是扫描的方向不同。后其实就是车和象的移动集合。这部分代码复用性很高。3.3 马Knight的移动固定位置跳跃马的走法是“日”字形不受中途格子影响。所以最简单直接硬编码8个可能的偏移量[(-2, -1), (-2, 1), (-1, -2), (-1, 2), (1, -2), (1, 2), (2, -1), (2, 1)]然后检查每个目标格是否在棋盘内并且没有己方棋子即可。3.4 王King的移动单步与易位王的普通移动是向周围8个方向走一格判断条件同马。王车易位是另一个规则难点。它需要同时满足多个条件王和要进行易位的车都从未移动过通过游戏状态中的易位权利标志位判断。王和车之间的所有格子都是空的。王在移动过程中起始格、途经格、目标格不会被对方将军。注意这里只检查王经过和到达的格子是否被攻击不检查起始格是否被将军因为被将军时本来就必须应将。王没有被将军这是移动前的总前提但易位是一种特殊的移动所以也适用。易位分为短易位王翼king-side和长易位后翼queen-side车移动的格子也不同。这部分逻辑需要仔细实现并在执行移动后更新对应方的易位权利为False。4. 从“伪合法”到“真合法”引入将军检测上一步我们生成的是“伪合法移动”Pseudo-legal Moves。意思是这些移动符合该棋子的走法规则但可能让己方王暴露在对方的攻击之下即“送将”。国际象棋规则禁止任何导致己方王被将军的移动。因此我们需要一个核心函数is_in_check(board, side)用于判断某一方是否正处于被将军状态。实现思路是找到该方王的位置。模拟对方所有棋子的所有伪合法移动注意这里计算对方移动时可以暂时忽略对方的将军状态因为我们要看的是攻击能力。检查是否有任何一个对方的伪合法移动的目标格正好是我方王的位置。如果有则我方被将军。有了这个函数我们就可以过滤伪合法移动生成“真合法移动”Legal Moves对于每一步伪合法移动在棋盘上模拟执行它生成一个新棋盘状态。在这个新状态下判断移动方即当前走棋方的王是否被将军。如果被将军则这一步是“送将”不合法过滤掉。如果没有被将军则这一步是合法的。这里有一个巨大的性能陷阱为每一步伪合法移动都模拟走棋并全盘计算是否被将军在后期棋子多时计算量会很大。但对于学习目的和基础引擎这是最清晰、最不容易出错的方式。优化如“攻击位图”、“Zobrist哈希”是后续进阶的话题。5. 胜负与和棋判定让游戏有始有终当一方没有合法移动时游戏结束。这里有两种情况将死Checkmate该方被将军且没有任何一步合法移动可以解除将军。对方获胜。逼和Stalemate该方没有被将军但没有任何一步合法移动可以走。游戏和棋。所以我们的游戏主循环逻辑是根据当前局面和走棋方生成所有合法移动。如果合法移动列表为空如果当前走棋方被将军 - 将死对方赢。如果当前走棋方未被将军 - 逼和和棋。如果列表不为空则等待玩家或AI选择一步走法。执行走法更新棋盘和游戏状态包括易位权利、吃过路兵目标格、回合计数等。切换走棋方回到第1步。除了逼和还有其他和棋规则需要判断可以在每次走棋后检查50步规则如果连续50个完整回合双方各走一步没有吃子且没有兵移动一方可以要求和棋。我们的halfmove_clock就是用于此。三次重复局面同一局面棋盘棋子位置、易位权利、吃过路兵目标、走棋方都相同出现三次一方可以要求和棋。这需要记录历史局面。双方子力不足以将死例如王对王、王象对王、王马对王等。可以硬编码一些子力组合来判断。对于第一个版本实现将死和逼和就足够了游戏已经可以完整运行。6. 构建可运行的引擎与常见问题排查现在我们把所有部分组合起来。一个最简化的引擎流程如下class ChessEngine: def __init__(self): self.board self.initial_board() self.side_to_move ‘white’ self.castling_rights {‘white_ks’: True, ‘white_qs’: True, ‘black_ks’: True, ‘black_qs’: True} self.en_passant_target None self.halfmove_clock 0 self.fullmove_number 1 self.move_history [] def generate_legal_moves(self): 为当前走棋方生成所有合法移动 pseudo_moves self.generate_pseudo_legal_moves() legal_moves [] for move in pseudo_moves: if self.make_move_and_check(move): # 模拟走棋并检查是否送将 legal_moves.append(move) return legal_moves def make_move(self, move): 正式执行一步移动更新所有状态 # 执行移动处理吃子、易位、吃过路兵等 # 更新易位权利 # 更新吃过路兵目标格 # 更新半回合和完整回合计数 # 切换走棋方 # 将移动加入历史 pass def play(self): 简单的主循环例如与自己下棋或对输入作出反应 while True: legal_moves self.generate_legal_moves() if not legal_moves: if self.is_in_check(self.side_to_move): print(f“Checkmate! {self.opponent(self.side_to_move)} wins.“) else: print(“Stalemate! Draw.“) break # 这里可以接入玩家输入或简单的AI print(f“{self.side_to_move} to move. Legal moves: {legal_moves}“) chosen_move input(“Enter your move: “) # 验证 chosen_move 是否在 legal_moves 中 self.make_move(chosen_move) self.print_board()在实现和测试过程中你几乎一定会遇到下面这些问题问题1棋子可以“穿墙”或走到奇怪的位置。排查首先检查你的“射线扫描”逻辑。确保在遇到棋子无论是己方还是对方时循环正确终止。一个常见的错误是吃子后没有break导致可以“穿过”对方棋子。问题2王车易位总是不成功。排查按顺序检查以下条件易位权利标志位是否正确初始化并在王或车移动后被正确置为False。王和车之间的格子是否真的为空用打印棋盘状态确认。你的is_in_check函数是否工作正常易位时需要检查王经过的格子对于短易位是f1和g1是否被攻击而不仅仅是目标格。问题3吃过路兵逻辑不触发。排查确认你在上一步对方兵移动两格时正确设置了en_passant_target是对方兵身后的那个格子不是兵本身的位置。确认本方兵在第五横线白兵在row3黑兵在row4且与en_passant_target在同一行列相邻。执行吃过路兵时不仅要移动本方兵到目标格还要从棋盘上移除对方兵其位置在目标格的同一列相邻行。问题4将军检测函数is_in_check运行极慢。原因这是正常的因为我们用最朴素的方式为每一步伪合法移动都模拟走棋并全盘扫描。对于学习和小规模测试没问题。优化方向进阶可以缓存对方的攻击格位图或者使用“位棋盘”Bitboard这种专门为棋类游戏设计的数据结构来高效计算攻击范围。但这属于性能优化范畴建议先确保基础逻辑完全正确。问题5游戏判断和棋或胜负的条件不对。排查确保你的generate_legal_moves返回的是过滤掉“送将”移动后的真合法移动。如果这个列表为空再去判断是否被将军。顺序不能反。7. 从引擎到应用下一步可以做什么当你完成了一个可以正确判断规则、生成合法移动、检测胜负的纯逻辑引擎后你已经掌握了最核心的部分。接下来你可以选择不同的方向深化1. 添加一个简单的用户界面UI命令行界面CLI用字符画棋盘通过输入坐标如“e2e4”来走棋。这是最快验证引擎交互性的方式。图形界面GUI使用Pygame、Tkinter等库绘制棋盘和棋子用鼠标点击操作。这需要将你的逻辑引擎与UI事件循环连接起来。2. 实现一个简单的AI对手随机走子从合法移动中随机选一个。这已经能下一个完整的棋了。极小化极大算法Minimax加入简单的局面评估函数根据棋子价值、位置好坏打分让AI寻找几步之内对自己最有利的走法。这是棋类AI的入门算法。Alpha-Beta剪枝优化Minimax大幅减少需要评估的节点数。3. 支持标准棋局格式FEN PGNFEN串一种用一行字符串表示整个棋盘状态的标准方法。实现FEN的导入和导出可以让你轻松设置任意局面进行测试或者与其他引擎对接。PGN格式记录整盘棋的走子过程。实现PGN导出可以保存你的对局。4. 进行单元测试为你的核心函数如移动生成、将军检测、易位判断编写单元测试。给定一个特定的棋盘局面验证函数输出是否符合预期。这是保证代码质量、防止后续修改引入错误的关键。回过头看“国际象棋但是纯代码”这个项目其魅力正在于这种从零开始构建规则世界的过程。它强迫你直面规则中所有的边界条件和细节把模糊的自然语言描述转化为精确的布尔逻辑。这个过程里踩的每一个“坑”都是对编程思维和问题分解能力的绝佳锻炼。我建议不要一开始就追求完美的架构或高性能先用最直白的方式把规则实现让它能跑起来。当你看到两个由你创造的“逻辑大脑”在棋盘上厮杀时那种成就感远非调用一个现成游戏库可比。
从零构建国际象棋规则引擎：算法、逻辑与工程实践详解
1. 先搞清楚“纯代码”国际象棋到底在玩什么看到“国际象棋但是纯代码”这个标题很多人的第一反应可能是这不就是个用代码实现的国际象棋游戏吗有什么特别的如果你也这么想那可能就错过了它最核心的玩法和挑战。这个项目真正的价值不在于“用代码画出一个棋盘”而在于用代码的逻辑和规则去模拟、推演甚至重构整个国际象棋的博弈过程。它考验的不是你的美术功底而是你的逻辑抽象能力、算法设计能力和对规则理解的深度。简单来说它解决的是“如何让计算机理解并执行国际象棋规则”的问题。这听起来基础但落地时从棋盘状态表示、棋子移动规则、特殊走法如王车易位、吃过路兵的判断到胜负判定将军、将死、逼和每一步都需要严谨的代码逻辑。对于开发者尤其是算法、游戏逻辑或AI入门的学习者这是一个绝佳的练手项目。它能让你深刻体会到将一套复杂的、充满例外情况的现实规则转化为无歧义的、可执行的代码是一个多么需要耐心和细心的过程。所以这篇文章不是教你画一个漂亮的棋盘界面而是带你从零开始用代码的思维搭建一套完整的、可运行的国际象棋规则引擎。我会按照实际开发的顺序从核心数据结构的定义到基础移动规则的实现再到复杂特殊规则的判断最后完成一个可以自己和自己下棋的“大脑”。即使你之前没做过游戏开发跟着这个思路走一遍也能对状态机、规则引擎有更扎实的理解。2. 环境与核心数据结构一切从“棋盘”开始在动手写任何移动逻辑之前我们必须先定义好棋盘和棋子的表示方式。这是整个项目的基石设计得好后续逻辑会清晰很多设计得不好后面会处处碰壁。我建议从最朴素、最直接的方式开始用一个8x8的二维数组来表示棋盘。数组的每个元素代表一个格子里面存放一个值用来表示这个格子上是什么棋子或者为空。2.1 如何表示棋子和棋盘一种常见且清晰的做法是使用字符或简单的枚举。例如# 使用字符表示棋子大写为白方小写为黑方 EMPTY . WHITE_PAWN P BLACK_PAWN p WHITE_ROOK R BLACK_ROOK r WHITE_KNIGHT N # 注意K已经被国王用了骑士通常用NKnight BLACK_KNIGHT n WHITE_BISHOP B BLACK_BISHOP b WHITE_QUEEN Q BLACK_QUEEN q WHITE_KING K BLACK_KING k # 初始化一个空棋盘 board [[EMPTY for _ in range(8)] for _ in range(8)]这样board[0][0]就可以是‘r’黑方左车board[6][4]可以是‘P’白方e2兵。这种表示法非常直观调试时一眼就能看出棋盘状态。除了棋盘状态我们还需要记录一些游戏状态信息这些是规则判断的关键当前轮到哪一方走棋side_to_move‘white’或‘black’。王车易位权利白王是否可以进行短易位white_kingside_castle、长易位white_queenside_castle黑方同理。一旦王或相应的车移动过这个权利就永久丧失。吃过路兵的目标格en_passant_target记录上一步对方兵前进两格后身后那个可以被“吃过路兵”的格子坐标。如果不存在则为None。半回合计数halfmove_clock用于50步和棋规则从上次吃子或兵移动开始计数。完整回合数fullmove_number从1开始白方走棋后计数增加。把这些状态封装在一个类或结构体里会非常方便。这就是我们游戏的“内存”。2.2 坐标系统的选择这里有一个细节需要注意数组索引和棋盘坐标的映射关系。国际象棋棋盘有8行rank1-8和8列filea-h。在程序中我们通常用(row, col)来表示一个格子。我个人的习惯是让row 0对应棋盘的第1行白方底线row 7对应第8行黑方底线col 0对应a列col 7对应h列。这样初始状态下白方王‘K’就在(0, 4)也就是e1格。这个映射关系一定要在开始时就确定下来并在所有函数中保持一致否则移动逻辑会彻底混乱。你可以写两个辅助函数来进行转换方便调试def square_to_coords(square): # 例如 ‘e4’ - (4, 4) file_char, rank_char square[0], square[1] col ord(file_char) - ord(a) row 8 - int(rank_char) return row, col def coords_to_square(row, col): # 例如 (4, 4) - ‘e4’ file_char chr(col ord(a)) rank_char str(8 - row) return file_char rank_char3. 实现基础移动规则让棋子“动起来”有了棋盘表示接下来就是重头戏为每种棋子定义它的合法移动规则。这里的“合法”指的是基于棋子自身走法规则的合法暂时先不考虑是否会把己方王暴露在将军下那是下一步要做的。我们的目标是写一个函数比如get_pseudo_legal_moves(board, position)输入棋盘和某个格子的坐标返回这个格子上的棋子所有可能走到的目标格列表伪合法移动。3.1 兵Pawn的移动最复杂的简单棋子兵的规则最多是第一个难点。它涉及向前走一格前提是目标格为空。起始位置向前走两格前提是起始格在初始行白兵在row6黑兵在row1且路径上两格都为空。斜向吃子向左前或右前移动一格前提是目标格有对方棋子。吃过路兵一种特殊的吃子方式。如果对方兵从上一步移动了两格正好停在我方兵相邻的侧方那么我方兵可以“斜向”移动到对方兵身后的那个空格并吃掉它。这需要利用我们之前记录的en_passant_target状态。代码逻辑上需要根据棋子颜色白或黑来决定“向前”是row增加还是减少。这里很容易出错建议单独为兵写一个函数把颜色作为参数。3.2 车Rook、象Bishop、后Queen的移动射线扫描这三种棋子的移动都是沿着直线车横竖象斜线后横竖斜直到被阻挡。 实现他们的通用方法是“射线扫描”。 以白车为例从它当前位置出发向四个方向上、下、左、右依次探索如果目标格为空则是一个合法移动继续向该方向看下一格。如果目标格有对方棋子则这是一个“吃子”移动将其加入列表然后停止该方向的扫描。如果目标格有己方棋子则不能移动停止该方向的扫描。象和后同理只是扫描的方向不同。后其实就是车和象的移动集合。这部分代码复用性很高。3.3 马Knight的移动固定位置跳跃马的走法是“日”字形不受中途格子影响。所以最简单直接硬编码8个可能的偏移量[(-2, -1), (-2, 1), (-1, -2), (-1, 2), (1, -2), (1, 2), (2, -1), (2, 1)]然后检查每个目标格是否在棋盘内并且没有己方棋子即可。3.4 王King的移动单步与易位王的普通移动是向周围8个方向走一格判断条件同马。王车易位是另一个规则难点。它需要同时满足多个条件王和要进行易位的车都从未移动过通过游戏状态中的易位权利标志位判断。王和车之间的所有格子都是空的。王在移动过程中起始格、途经格、目标格不会被对方将军。注意这里只检查王经过和到达的格子是否被攻击不检查起始格是否被将军因为被将军时本来就必须应将。王没有被将军这是移动前的总前提但易位是一种特殊的移动所以也适用。易位分为短易位王翼king-side和长易位后翼queen-side车移动的格子也不同。这部分逻辑需要仔细实现并在执行移动后更新对应方的易位权利为False。4. 从“伪合法”到“真合法”引入将军检测上一步我们生成的是“伪合法移动”Pseudo-legal Moves。意思是这些移动符合该棋子的走法规则但可能让己方王暴露在对方的攻击之下即“送将”。国际象棋规则禁止任何导致己方王被将军的移动。因此我们需要一个核心函数is_in_check(board, side)用于判断某一方是否正处于被将军状态。实现思路是找到该方王的位置。模拟对方所有棋子的所有伪合法移动注意这里计算对方移动时可以暂时忽略对方的将军状态因为我们要看的是攻击能力。检查是否有任何一个对方的伪合法移动的目标格正好是我方王的位置。如果有则我方被将军。有了这个函数我们就可以过滤伪合法移动生成“真合法移动”Legal Moves对于每一步伪合法移动在棋盘上模拟执行它生成一个新棋盘状态。在这个新状态下判断移动方即当前走棋方的王是否被将军。如果被将军则这一步是“送将”不合法过滤掉。如果没有被将军则这一步是合法的。这里有一个巨大的性能陷阱为每一步伪合法移动都模拟走棋并全盘计算是否被将军在后期棋子多时计算量会很大。但对于学习目的和基础引擎这是最清晰、最不容易出错的方式。优化如“攻击位图”、“Zobrist哈希”是后续进阶的话题。5. 胜负与和棋判定让游戏有始有终当一方没有合法移动时游戏结束。这里有两种情况将死Checkmate该方被将军且没有任何一步合法移动可以解除将军。对方获胜。逼和Stalemate该方没有被将军但没有任何一步合法移动可以走。游戏和棋。所以我们的游戏主循环逻辑是根据当前局面和走棋方生成所有合法移动。如果合法移动列表为空如果当前走棋方被将军 - 将死对方赢。如果当前走棋方未被将军 - 逼和和棋。如果列表不为空则等待玩家或AI选择一步走法。执行走法更新棋盘和游戏状态包括易位权利、吃过路兵目标格、回合计数等。切换走棋方回到第1步。除了逼和还有其他和棋规则需要判断可以在每次走棋后检查50步规则如果连续50个完整回合双方各走一步没有吃子且没有兵移动一方可以要求和棋。我们的halfmove_clock就是用于此。三次重复局面同一局面棋盘棋子位置、易位权利、吃过路兵目标、走棋方都相同出现三次一方可以要求和棋。这需要记录历史局面。双方子力不足以将死例如王对王、王象对王、王马对王等。可以硬编码一些子力组合来判断。对于第一个版本实现将死和逼和就足够了游戏已经可以完整运行。6. 构建可运行的引擎与常见问题排查现在我们把所有部分组合起来。一个最简化的引擎流程如下class ChessEngine: def __init__(self): self.board self.initial_board() self.side_to_move ‘white’ self.castling_rights {‘white_ks’: True, ‘white_qs’: True, ‘black_ks’: True, ‘black_qs’: True} self.en_passant_target None self.halfmove_clock 0 self.fullmove_number 1 self.move_history [] def generate_legal_moves(self): 为当前走棋方生成所有合法移动 pseudo_moves self.generate_pseudo_legal_moves() legal_moves [] for move in pseudo_moves: if self.make_move_and_check(move): # 模拟走棋并检查是否送将 legal_moves.append(move) return legal_moves def make_move(self, move): 正式执行一步移动更新所有状态 # 执行移动处理吃子、易位、吃过路兵等 # 更新易位权利 # 更新吃过路兵目标格 # 更新半回合和完整回合计数 # 切换走棋方 # 将移动加入历史 pass def play(self): 简单的主循环例如与自己下棋或对输入作出反应 while True: legal_moves self.generate_legal_moves() if not legal_moves: if self.is_in_check(self.side_to_move): print(f“Checkmate! {self.opponent(self.side_to_move)} wins.“) else: print(“Stalemate! Draw.“) break # 这里可以接入玩家输入或简单的AI print(f“{self.side_to_move} to move. Legal moves: {legal_moves}“) chosen_move input(“Enter your move: “) # 验证 chosen_move 是否在 legal_moves 中 self.make_move(chosen_move) self.print_board()在实现和测试过程中你几乎一定会遇到下面这些问题问题1棋子可以“穿墙”或走到奇怪的位置。排查首先检查你的“射线扫描”逻辑。确保在遇到棋子无论是己方还是对方时循环正确终止。一个常见的错误是吃子后没有break导致可以“穿过”对方棋子。问题2王车易位总是不成功。排查按顺序检查以下条件易位权利标志位是否正确初始化并在王或车移动后被正确置为False。王和车之间的格子是否真的为空用打印棋盘状态确认。你的is_in_check函数是否工作正常易位时需要检查王经过的格子对于短易位是f1和g1是否被攻击而不仅仅是目标格。问题3吃过路兵逻辑不触发。排查确认你在上一步对方兵移动两格时正确设置了en_passant_target是对方兵身后的那个格子不是兵本身的位置。确认本方兵在第五横线白兵在row3黑兵在row4且与en_passant_target在同一行列相邻。执行吃过路兵时不仅要移动本方兵到目标格还要从棋盘上移除对方兵其位置在目标格的同一列相邻行。问题4将军检测函数is_in_check运行极慢。原因这是正常的因为我们用最朴素的方式为每一步伪合法移动都模拟走棋并全盘扫描。对于学习和小规模测试没问题。优化方向进阶可以缓存对方的攻击格位图或者使用“位棋盘”Bitboard这种专门为棋类游戏设计的数据结构来高效计算攻击范围。但这属于性能优化范畴建议先确保基础逻辑完全正确。问题5游戏判断和棋或胜负的条件不对。排查确保你的generate_legal_moves返回的是过滤掉“送将”移动后的真合法移动。如果这个列表为空再去判断是否被将军。顺序不能反。7. 从引擎到应用下一步可以做什么当你完成了一个可以正确判断规则、生成合法移动、检测胜负的纯逻辑引擎后你已经掌握了最核心的部分。接下来你可以选择不同的方向深化1. 添加一个简单的用户界面UI命令行界面CLI用字符画棋盘通过输入坐标如“e2e4”来走棋。这是最快验证引擎交互性的方式。图形界面GUI使用Pygame、Tkinter等库绘制棋盘和棋子用鼠标点击操作。这需要将你的逻辑引擎与UI事件循环连接起来。2. 实现一个简单的AI对手随机走子从合法移动中随机选一个。这已经能下一个完整的棋了。极小化极大算法Minimax加入简单的局面评估函数根据棋子价值、位置好坏打分让AI寻找几步之内对自己最有利的走法。这是棋类AI的入门算法。Alpha-Beta剪枝优化Minimax大幅减少需要评估的节点数。3. 支持标准棋局格式FEN PGNFEN串一种用一行字符串表示整个棋盘状态的标准方法。实现FEN的导入和导出可以让你轻松设置任意局面进行测试或者与其他引擎对接。PGN格式记录整盘棋的走子过程。实现PGN导出可以保存你的对局。4. 进行单元测试为你的核心函数如移动生成、将军检测、易位判断编写单元测试。给定一个特定的棋盘局面验证函数输出是否符合预期。这是保证代码质量、防止后续修改引入错误的关键。回过头看“国际象棋但是纯代码”这个项目其魅力正在于这种从零开始构建规则世界的过程。它强迫你直面规则中所有的边界条件和细节把模糊的自然语言描述转化为精确的布尔逻辑。这个过程里踩的每一个“坑”都是对编程思维和问题分解能力的绝佳锻炼。我建议不要一开始就追求完美的架构或高性能先用最直白的方式把规则实现让它能跑起来。当你看到两个由你创造的“逻辑大脑”在棋盘上厮杀时那种成就感远非调用一个现成游戏库可比。
