如何将Python无GUI CLI程序编译为可在Windows10运行的.exe？

你遇到的"Failed to execute the script"错误是PyInstaller打包CLI程序时的常见问题，咱们一步步来排查解决：

• 先确保你的脚本本身能正常运行
  打包前先在本地用Python直接执行脚本：python your_script.py，确认它在控制台里能正常输出、完成功能，没有任何报错。如果脚本本身有bug，打包后肯定会执行失败，这是最基础的检查步骤。

• 用正确的PyInstaller打包命令（别加GUI参数）
  你之前打包GUI版本可能用了--windowed或--noconsole来隐藏控制台，但CLI版本绝对不能加这些参数！正确的基础打包命令是：
  pyinstaller your_script.py
  如果想生成单个可执行文件（方便分发），就用：
  pyinstaller --onefile your_script.py
  加了--windowed会导致CLI程序无法正常输出/接收输入，反而会触发执行错误。

• 排查依赖缺失问题
  如果你的脚本用到了第三方库，PyInstaller有时候可能没自动识别并打包所有依赖。你可以通过以下方式排查：

  1. 打开CMD，导航到生成的dist文件夹（比如cd dist），然后运行你的.exe：your_script.exe，这样控制台会保留错误信息，你能看到具体是哪个模块找不到。
  2. 找到缺失的模块后，用--hidden-import参数手动指定，比如脚本用到了pandas，命令就改成：
     pyinstaller --onefile --hidden-import pandas your_script.py

• 处理路径问题（如果脚本用到本地文件）
  如果你的脚本需要读取本地文件（比如单词列表、配置文件），打包成.exe后，脚本的运行路径会变成系统临时目录，硬编码的路径会失效。你可以在脚本里用动态路径获取：

  import os
  # 获取脚本的实际运行路径
  base_dir = os.path.dirname(os.path.abspath(__file__))
  # 拼接文件路径
  target_file = os.path.join(base_dir, "your_file.txt")
  

  这样不管是直接运行脚本还是运行打包后的.exe，都能正确找到文件。

• 清理旧打包缓存后重新打包
  有时候之前打包留下的build文件夹、dist文件夹和.spec文件会有缓存问题，导致新打包的程序出错。先删除这些文件，再重新执行打包命令，避免缓存干扰。

按照这些步骤操作，你的CLI版本应该能正常打包并在任意Windows10环境运行啦！

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