Python使用PyInstaller将源文件打包为EXE可执行文件详解

叶初
叶初
发布时间:2026-10-13| 6人浏览过
原创

本文介绍如何使用PyInstaller库将Python源文件打包为Windows、Linux或Mac OS下的可执行文件。文章详细讲解了通过pip安装PyInstaller的方法,演示了生成包含依赖库的文件夹及生成独立EXE文件(-F参数)的具体命令,并列举了路径限制、编码要求及常用命令行参数,帮助开发者实现Python程序的便捷分发。

PyInstaller库的使用方法

PyInstaller是一款实用的第三方库,支持在Windows、Linux以及Mac OS X等多种操作系统中将Python源代码打包。通过打包操作,生成的Python程序无需安装Python环境即可运行,同时也便于作为独立文件进行分发与管理。安装PyInstaller需通过命令行(控制台)使用pip工具,具体命令如下:

:\>pip install pyinstaller 

或者

:\>pip3 install pyinstaller 

PyInstaller的官方网址为http://www.pyinstaller.org/。安装完成后,PyInstaller命令会自动注册到Python解释器目录中,路径与pip或pip3命令一致,因此可直接调用。使用PyInstaller非常简单,但需注意:源文件名中不能包含英文句号(.)。例如,若源文件dpython.py位于D:\codes目录,可执行以下命令:

:\>pyinstaller dpython.py 

或者

:\>pyinstaller D:\codes\dpython.py 

命令执行完毕后,源文件所在目录会生成dist和build两个文件夹。其中,build目录用于存储打包过程中的临时文件,确认打包成功后可安全删除。最终的打包程序位于dist目录下的dpython文件夹中,该文件夹内除可执行文件dpython.exe外,还包含其依赖的动态链接库。若希望生成单个独立的可执行文件,可使用-F参数,命令如下:

:\>pyinstaller -F dpython.py 

执行上述命令后,dist目录中将生成dpython.exe文件。该文件不依赖任何外部库,直接双击即可运行。使用PyInstaller时需注意以下几点:文件路径中不得包含空格和英文句号(.);源文件必须采用UTF-8编码,目前暂不支持其他编码格式。使用IDLE编写的源文件默认保存为UTF-8编码,可直接用于打包。PyInstaller提供了一些常用参数,具体如下:

-h, --help 查看帮助信息 -v, --version

查看PyInstaller的版本号

--clean 清理打包过程中产生的临时文件 -D, --onedir 默认模式,生成包含依赖文件的dist目录 -F, --onefile 在dist文件夹中仅生成独立的打包文件(单文件模式) -p DIR, --paths DIR 指定Python源文件引用的第三方库路径 -i <.ico or .exe,ID or .icns>,--icon <.ico or .exe,ID or .icns >指定打包程序使用的图标文件

使用PyInstaller进行打包无需在Python源文件中添加额外代码,仅需通过命令行执行打包指令即可。其中,-F参数最为常用,用于生成独立的可执行文件。对于包含第三方库的源文件,若这些库通过pip安装且位于Python环境目录中,则无需使用-p参数;若第三方库位于其他路径,可通过-p参数添加该路径以便打包程序正确引用。

相关标签:

免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。

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 算法库。