执行PyInstaller打包命令时持续出现UnicodeEncodeError编码错误求助

这是PyInstaller旧版本在Windows环境下的典型编码兼容问题，我帮你梳理下原因和解决办法：

问题根源 #

你遇到的UnicodeEncodeError本质是路径中包含非ASCII字符（比如中文、特殊符号），而PyInstaller 3.3.1这个2018年的旧版本，对非ASCII路径的支持非常差。在生成spec配置文件时，它默认用Windows控制台的cp1252编码处理内容，这种编码无法识别中文等特殊字符，直接触发了编码失败。从错误日志里的specfile.write(onedirtmplt % d)也能看出，问题就出在生成spec文件的环节。

可行解决方案（按优先级排序） #

• 优先升级PyInstaller到新版本：这个编码问题在后续版本已经被完全修复了。打开命令行执行：

  pip install --upgrade pyinstaller
  

  建议升级到4.0以上的稳定版，新版本对Windows下的UTF-8路径支持完善很多。

• 临时方案：使用纯ASCII路径：如果暂时无法升级，把你的脚本移动到全英文/数字的路径下，比如C:\temp\myscript.py，确保路径里没有中文、空格或特殊符号，再执行打包命令就能正常运行。

• 强制Python用UTF-8编码处理：在执行PyInstaller前先设置环境变量，强制Python以UTF-8编码处理文件：

  • Windows CMD环境：

    set PYTHONUTF8=1
    pyinstaller myscript.py
    

  • Windows PowerShell环境：

    $env:PYTHONUTF8=1
    pyinstaller myscript.py
    

快速验证 #

你可以创建一个最简单的test.py（内容仅print("Hello")），放到纯英文路径下执行打包命令，如果能成功生成exe，就确认是路径中的非ASCII字符导致的问题。

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