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

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

本文详解如何利用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 相关产品和应用

全部下载
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架,支持类型提示和自动接口文档。

Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

Django

Django

6.1.2 · Windows

成熟的 Python Web 框架,适合构建内容站点和业务系统。

Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。