Pyinstaller打包Python脚本失败：只生成spec文件的原因及解决方案
使用Pyinstaller打包Python脚本时，有时只会生成
文件，而没有生成可执行文件（
）。本文分析此问题，并提供有效解决方案。
问题：用户使用
命令打包，结果仅生成
文件，并出现
错误。此错误表明Pyinstaller在处理脚本文件时遇到编码问题，它尝试使用UTF-8解码，但脚本文件可能使用了其他编码（如GB2312），导致解码失败。
无效尝试：用户尝试了添加编码声明
，修改Pyinstaller的
文件，以及设置命令行编码为UTF-8。这些方法通常用于解决编码问题，但并未解决根本问题。
立即学习
“
Python免费学习笔记（深入）
”；
Python 3.14.3
微软官方的 Python 扩展，是 VS Code 安装量最高的扩展（209M+）。集成 IntelliSense（通过 Pylance）、调试（通过 Python Debugger）、代码检查、格式化、重构和单元测试等功能。支持 Jupyter Notebook、虚拟环境管理和多 Python 版本切换。
下载
根本原因：脚本文件编码与Pyinstaller默认的UTF-8编码不一致。即使修改了脚本编码，Pyinstaller在构建过程中可能仍然读取到错误的编码信息。直接修改
风险较大，不推荐。设置命令行编码也无法改变脚本文件本身的编码。
解决方案：确保脚本文件使用UTF-8编码，并让Pyinstaller正确识别。建议使用支持UTF-8编码的文本编辑器（如Notepad++、Sublime Text）打开脚本，另存为UTF-8编码，然后重新运行打包命令。如果脚本包含非UTF-8字符，需将其转换为UTF-8。
如果问题仍然存在，可以考虑使用其他打包工具，例如Nuitka。Nuitka将Python代码编译成C代码，再编译成可执行文件，能有效避免编码问题。
.spec.exepyinstaller -F -w test.py.specUnicodeDecodeError: 'utf-8' codec can't decode byte 0xbd in position 4: invalid start byte# -*- coding: utf-8 -*-compat.pycompat.py