Windows下Jupyter调用chess.engine.popen_uci报NotImplementedError

问题核心 #

Windows环境下Jupyter Notebook的子进程IO处理模型与命令行存在差异，导致chess.engine.SimpleEngine.popen_uci无法正常初始化Stockfish引擎，而命令行和Ubuntu环境不受此影响。

解决方案 #

1. 明确指定Stockfish二进制文件的绝对路径

命令行环境可能通过系统PATH自动找到Stockfish可执行文件，但Jupyter的环境变量配置可能未包含该路径。直接传入绝对路径可避免路径查找问题：

import chess.engine
# 替换为你的Stockfish二进制文件实际路径
engine_path = r"C:\tools\stockfish17.1\stockfish-windows-x86-64-avx2.exe"
engine = chess.engine.SimpleEngine.popen_uci(engine_path)

# 测试引擎
board = chess.Board()
result = engine.play(board, chess.engine.Limit(time=0.2))
print(f"推荐走法: {result.move}")

# 记得关闭引擎
engine.quit()

2. 手动创建子进程并绑定到SimpleEngine

绕过popen_uci的默认处理逻辑，直接用subprocess创建子进程并手动管理IO流，适配Jupyter的环境：

import chess.engine
import subprocess

# 启动Stockfish子进程
engine_process = subprocess.Popen(
    ["C:\\tools\\stockfish17.1\\stockfish-windows-x86-64-avx2.exe"],
    stdin=subprocess.PIPE,
    stdout=subprocess.PIPE,
    stderr=subprocess.STDOUT,
    text=True,
    creationflags=subprocess.CREATE_NO_WINDOW  # 避免弹出额外控制台窗口
)

# 将子进程的IO流绑定到SimpleEngine
engine = chess.engine.SimpleEngine(engine_process.stdin, engine_process.stdout)

try:
    # 测试引擎功能
    board = chess.Board()
    result = engine.play(board, chess.engine.Limit(depth=5))
    print(f"推荐走法: {result.move}")
finally:
    # 确保资源被正确释放
    engine.quit()
    engine_process.wait()

3. 同步Jupyter与命令行的环境变量

Jupyter的PATH环境变量可能与命令行不一致，导致无法找到Stockfish。验证并修复：

import os
# 打印Jupyter当前的PATH
print(os.environ["PATH"])
# 如果Stockfish所在目录不在其中，手动添加
os.environ["PATH"] += ";C:\\tools\\stockfish17.1"

添加后再尝试调用popen_uci。

4. 降级Python版本（临时兼容方案）

Python 3.13属于较新的版本，可能与chess库的子进程处理逻辑存在兼容性问题。尝试降级到Python 3.12，重新安装chess、stockfish依赖后再测试。

内容的提问来源于stack exchange，提问作者Google Gauner