开发Mailbox国际象棋引擎：GenerateAllMoves函数异常修复

问题现象 #

开发基于Mailbox结构的国际象棋引擎时，GenerateAllMoves函数未按预期工作：白方初始位置的合法走棋输出包含错误记录，与标准初始合法走法（所有兵前进1或2格、马的合法跳步等）不符。

问题根因 #

问题出在坐标转换函数squareMapper和squareReverseMapper上。这两个函数负责棋盘位置（如a1、h8）与Mailbox数组索引的相互映射，若实现逻辑错误，会导致棋子位置判断、走棋生成时的坐标对应关系混乱，最终生成错误的走棋记录。

修复方案 #

修正squareMapper和squareReverseMapper的坐标转换逻辑，确保棋盘坐标与Mailbox数组索引的映射完全匹配你的棋盘定义。

举个常见错误与修复的例子：

• 错误实现（行/列颠倒导致坐标映射错位）：

  def squareMapper(x, y):
      # x为列索引(a-h对应0-7)，y为行索引(1-8对应0-7)，错误将行作为第一维度计算索引
      return x * 8 + y
  
  def squareReverseMapper(index):
      x = index // 8
      y = index % 8
      return (x, y)
  

• 修复后的实现（匹配标准棋盘行从上到下、列从左到右的Mailbox索引逻辑）：

  def squareMapper(x, y):
      # x: 列索引(0=a,7=h), y: 行索引(0=第8行,7=第1行)
      return (7 - y) * 8 + x
  
  def squareReverseMapper(index):
      x = index % 8
      y = 7 - (index // 8)
      return (x, y)
  

修正后重新运行GenerateAllMoves函数，白方初始位置的合法走棋即可恢复为标准结果。

内容的提问来源于stack exchange，提问作者just a beginner