使用PyInstaller将Python脚本打包为独立EXE文件的完整指南

Finn
Finn
发布时间:2026-10-13 | 2人浏览过
原创

本文详解如何利用PyInstaller将Python脚本打包为独立的Windows可执行文件。涵盖环境配置、依赖安装、基础打包命令及去除黑色控制台窗口的技巧,帮助开发者轻松发布脱离Python环境的桌面应用。

前言

在日常开发中,经常需要运行某个Python脚本。为了方便在不同电脑上使用,希望将Python脚本发布为脱离Python运行环境的独立可执行程序,例如单个EXE文件。PyInstaller工具正好能满足这一需求。

需要注意的是,PyInstaller本身并非标准的Python第三方包。因此,在使用PyInstaller之前,必须确保本地的Python运行环境已经正确配置完毕。

安装PyInstaller

下载PyInstaller

将下载的压缩包解压至指定目录,例如 F:\PyInstaller-2.1(路径可自选)。建议前往官网下载最新版本的PyInstaller。

安装pywin32

下载并安装 pywin32-217.win32-py2.7.exe:点击下载

安装PyInstaller

1、打开命令行工具(cmd)

cd F:\PyInstaller-2.1
python pyinstaller.py --console --onefile test.py

如果在执行命令时提示:

Usage: python pyinstaller.py [opts] [ …] | 
pyinstaller.py: error: Requires at least one scriptname file or exactly one .spec-file

则说明PyInstaller安装成功。

测试打包

1、将待打包的Python文件放置在当前目录下的 pyinstaller-2.1 文件夹中

cd F:\PyInstaller-2.1
python pyinstaller.py --console --onefile test.py

2、命令执行成功后,会生成一个名为 test 的文件夹。在该文件夹下存在一个名为 dist 的子文件夹,其中包含转换生成的 test.exe 文件

3、上述编译生成的EXE文件可以正常运行,但启动时会伴随一个黑色的控制台窗口。如需隐藏该窗口,需重新编译并添加 --windowed 和 --icon 参数,同时移除 --console 参数

python pyinstaller.py -w --onefile --icon="my.ico" test.py

其中 my.ico 是用于替换程序图标的自定义图标文件。

总结

以上就是本文的全部内容,希望这些内容能对大家在Python学习或实际使用中有所帮助。如有任何疑问,欢迎留言交流,感谢大家对本站的支持。

相关标签:

本站声明

本文内容仅供参考,不代表本站观点。转载或引用请注明出处。如发现内容问题,请通过联系我们页面反馈。

Python 相关产品和应用

全部下载

专题列表