PyInstaller打包Python脚本时，只生成spec文件而不生成exe文件的常见原因及解决方案
使用PyInstaller打包Python程序时，有时会遇到只生成.spec文件而没有生成.exe文件的情况。这通常是由于编码问题或其他潜在问题导致PyInstaller在打包过程中出错。本文将分析此问题，并提供有效的解决方法。
问题描述：
许多用户在使用pyinstaller -F -w test.py命令打包时，遇到UnicodeDecodeError: 'utf-8' codec can't decode byte ... : invalid start byte错误，导致只生成.spec文件。此错误表明PyInstaller在读取Python脚本时，无法正确解码脚本文件的编码。
立即学习“Python免费学习笔记（深入）”；
根本原因：
问题根源在于PyInstaller与脚本文件编码的冲突。即使在脚本开头添加# -*- coding: utf-8 -*-，也可能无法解决问题，因为这仅对Python解释器有效，而PyInstaller可能使用不同的解码方式。修改PyInstaller的compat.py文件风险较高，不建议尝试。
解决方案：
-
将脚本文件转换为UTF-8编码：这是最直接有效的解决方法。使用支持UTF-8编码的文本编辑器（例如Notepad++、Sublime Text等），打开你的Python脚本，将编码更改为UTF-8并保存。 务必在保存后，用UTF-8编码重新打开文件，验证转换是否成功。
-
重新运行PyInstaller打包命令：完成编码转换后，再次运行
pyinstaller -F -w test.py命令。这将强制PyInstaller使用正确的编码读取脚本。 -
检查脚本文件中的非UTF-8字符：如果步骤1和2仍然无效，仔细检查脚本中是否存在非UTF-8字符，例如特殊符号或从其他编码方式复制粘贴的文本。这些字符可能会导致PyInstaller解码失败。 考虑使用专业的编码转换工具来处理这些字符。
-
考虑使用其他打包工具： 如果以上方法都无法解决问题，可以考虑尝试其他的打包工具，例如Nuitka。 然而，优先解决编码问题仍然是最佳方案。
通过以上步骤，您应该能够成功解决PyInstaller只生成.spec文件的问题，并成功打包您的Python脚本为可执行文件。 记住，确保你的脚本文件使用UTF-8编码是关键。
