如何将含Stockfish的大型Python项目打包为EXE文件

先排查核心路径问题 #

• 确保代码中Stockfish的引用为相对路径：替换硬编码的绝对路径，用动态路径获取。例如：

  import os
  # 获取当前脚本所在目录，拼接Stockfish路径
  stockfish_path = os.path.join(os.path.dirname(os.path.abspath(__file__)), "stockfish.exe")
  

  如果Stockfish放在PyTask_chess/PyTask/chess/下，要根据入口脚本的位置调整路径层级。
• 确认auto-py-to-exe的工作目录：打包时需将工作目录设置为项目根目录PyTask_chess，避免脚本找不到子目录下的文件。

使用auto-py-to-exe正确打包 #

• 打开auto-py-to-exe，在Script Location选择项目主入口脚本（如main.py）的完整路径。
• 选择One Directory模式（大型项目更稳定，减少路径冲突），而非单文件模式。
• 切换到Additional Files标签，点击Add Files添加Stockfish二进制文件，在Destination列填写与项目中一致的相对路径（如PyTask/chess/），确保打包后文件结构和原项目一致。
• 点击Convert .py to .exe完成打包。

用PyInstaller命令行打包（更可控） #

若auto-py-to-exe仍有问题，直接使用PyInstaller命令行：

1. 打开命令行，进入项目根目录PyTask_chess。
2. 执行对应系统的打包命令：
   • Windows系统：

     pyinstaller --onedir --add-data "PyTask/chess/stockfish.exe;PyTask/chess/" main.py
     

   • Linux/macOS系统：

     pyinstaller --onedir --add-data "PyTask/chess/stockfish:PyTask/chess/" main.py
     

3. 打包完成后，在dist/main目录中找到生成的可执行文件，Stockfish会自动复制到对应路径下。

验证打包结果 #

运行生成的EXE文件，检查是否能正常调用Stockfish。若仍报错，查看程序运行时的工作目录，确认Stockfish是否存在于预期路径中。

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