如何理解Chess.js中chess.fen()方法返回的fen字符串各参数作用
Chess.js 输出FEN的字段作用及e3标记的技术说明
以下解释完全匹配使用Chess.js做开发的实际场景,不涉及通用国际象棋记谱的冗余背景,只讲库内部对这些字段的使用逻辑:
KQkq(王车易位权限字段)
这是Chess.js用于校验当前局面下合法易位操作的状态标记,字符与权限的对应关系为:
K:白方保留王翼易位(O-O)权限Q:白方保留后翼易位(O-O-O)权限k:黑方保留王翼易位权限q:黑方保留后翼易位权限
如果某类权限失效(比如王/对应位置的车已经移动过、王易位路径上的格子被对方棋子攻击),对应的字符会被直接删除;如果所有易位权限都失效,这个字段会替换为-。
执行e4走子后该字段仍为KQkq,是因为这次移动的是e线白兵,完全不影响王、车的位置和易位路径,四类易位权限全部保留。
e3(吃过路兵目标格字段)
这是很多用Chess.js开发的人第一次接触都会产生误解的字段:它根本不记录刚完成的走子位置。Chess.js用这个字段存储后续可执行过路兵吃子的目标落点,生成逻辑非常固定:
- 仅当某一方的兵从初始位置一次跨走两格(比如白兵从e2走到e4、黑兵从e7走到e5),且相邻列存在对方可执行过路兵的兵时,才会生成这个标记
- 标记的坐标永远是这个跨两格的兵跳过的中间格:走e2→e4时,棋子跨过了e3格,因此该字段填
e3,代表如果黑方在d4或f4位置有兵,下一手可以通过d4xe3或f4xe3的操作,吃掉刚走到e4的白兵 - 如果当前局面没有可执行的过路兵条件,这个字段会填
-(比如下次走非兵类操作后,这个标记就会消失)
简单说:e3是为过路兵规则做的预判标记,和实际走的e4操作没有记录上的冲突,是完全符合状态存储逻辑的正常输出,不是Chess.js的bug。
0(半回合计数字段)
Chess.js用这个字段实现50回合和棋规则的自动判定:
- 每走一步未吃子、且非兵的移动,该数字自动+1
- 只要走了兵的移动、或者完成了一次吃子操作,该数字直接重置为0
走e4的操作属于兵的移动,触发了计数重置,因此该值为0。当这个数字累计到100(对应50个完整回合的无兵动、无吃子状态),Chess.js就会自动判定局面为和棋。
1(全回合计数字段)
这个字段用于记录当前棋局的完整回合数(一个完整回合 = 白方走一步 + 黑方走一步):
- 初始状态下白方要走第1回合的第一步,因此值为1
- 走完e4后,轮到黑方走第1回合的黑方步,黑方还未完成该回合的操作,因此值仍为1
- 等黑方走完第一步后,下次调用
chess.fen()时,该值就会变为2
内容的提问来源于stack exchange,提问作者James Urian
相关产品推荐
相关产品推荐

