Pyinstaller打包Python脚本失败：只生成spec文件的原因及解决方案

使用Pyinstaller打包Python脚本时，有时只会生成.spec文件，而没有生成可执行文件（.exe）。本文分析此问题，并提供有效解决方案。

问题：用户使用pyinstaller -F -w test.py命令打包，结果仅生成.spec文件，并出现UnicodeDecodeError: 'utf-8' codec can't decode byte 0xbd in position 4: invalid start byte错误。此错误表明Pyinstaller在处理脚本文件时遇到编码问题，它尝试使用UTF-8解码，但脚本文件可能使用了其他编码（如GB2312），导致解码失败。

无效尝试：用户尝试了添加编码声明# -*- coding: utf-8 -*-，修改Pyinstaller的compat.py文件，以及设置命令行编码为UTF-8。这些方法通常用于解决编码问题，但并未解决根本问题。

361SCAN security check your skill python scripts

扫描并分析已安装技能，用于查看指定技能目录的名称、描述和详情，或列出所有已安装的技能。

下载

立即学习“Python免费学习笔记（深入）”；

根本原因：脚本文件编码与Pyinstaller默认的UTF-8编码不一致。即使修改了脚本编码，Pyinstaller在构建过程中可能仍然读取到错误的编码信息。直接修改compat.py风险较大，不推荐。设置命令行编码也无法改变脚本文件本身的编码。

解决方案：确保脚本文件使用UTF-8编码，并让Pyinstaller正确识别。建议使用支持UTF-8编码的文本编辑器（如Notepad++、Sublime Text）打开脚本，另存为UTF-8编码，然后重新运行打包命令。如果脚本包含非UTF-8字符，需将其转换为UTF-8。

如果问题仍然存在，可以考虑使用其他打包工具，例如Nuitka。Nuitka将Python代码编译成C代码，再编译成可执行文件，能有效避免编码问题。