You need to enable JavaScript to run this app. 如何理解Chess.js中chess.fen()方法返回的fen字符串各参数作用
优惠活动
大模型
产品
解决方案
定价
更多

如何理解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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.09 00:15:10