python学习笔记（2）——PyInstaller 安装与使用（python打包成exe文件）

最新推荐文章于 2025-07-11 17:11:00 发布

原创最新推荐文章于 2025-07-11 17:11:00 发布 · 764 阅读

3 ·

CC 4.0 BY-SA版权

文章标签：

#Python #pyinstaller

Python 专栏收录该内容

34 篇文章

订阅专栏

本文介绍如何使用PyInstaller将Python脚本打包成独立的可执行文件。包括PyInstaller的安装方法、常用命令及其用法示例。适用于希望将Python程序转换为跨平台可执行文件的开发者。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

一、简介与下载

PyInstaller 其实就是把 python 解析器和脚本打包成一个可执行的文件。不像打开 py 文件需要安装python和依赖包。支持 Windows、Linux 和 Mac OS X。

PyInstaller 官网下载

注意：PyInstaller 4.0 只支持Python 3.5-3.7.

我同时安装了几个版本的 Python，在系统环境变量的路径里把Python37移到最上面，PyInstaller 就会默认安装在python37的目录下。

二、安装

进入包目录，执行下面的命令安装（需要安装 setuptools）：

python setup.py install

通过查询版本号判断是否安装成功：

pyinstaller --version

三、使用

（1）命令执行窗口

进入工程文件夹目录，删除文件夹原本的路径，然后输入cmd，点击回车，就会打开dos命令窗口，并且直接跳到指定文件夹目录下了。

2、pyinstaller打包命令列举

-F 表示生成单个可执行文件
-w 表示去掉控制台窗口，在需要GUI界面时非常有用。如果是命令行程序的话就不需要这个项。
-p 表示设置导入路径，指定多个目录，指定其他文件
-i 表示可执行文件的图标

执行命令打包：

pyinstaller -F -w .\main.py

多个py打包：

pyinstaller [主文件] -p [其他文件1] -p [其他文件2] --hidden-import [自建模块1] --hidden-import [自建模块2]
pyinstaller -F -w .\main.py -p .\ui_demo.py

常用命令：

-F, –onefile	产生一个文件用于部署 (参见XXXXX).
-D, –onedir	产生一个目录用于部署 (默认)
-K, –tk	在部署时包含 TCL/TK
-a, –ascii	不包含编码.在支持Unicode的python版本上默认包含所有的编码.
-d, –debug	产生debug版本的可执行文件
-w,–windowed,–noconsole	使用Windows子系统执行.当程序启动的时候不会打开命令行(只对Windows有效)
-c,–nowindowed,–console	使用控制台子系统执行(默认)(只对Windows有效)
-s,–strip	可执行文件和共享库将run through strip.注意Cygwin的strip往往使普通的win32 Dll无法使用.
-X, –upx	如果有UPX安装(执行Configure.py时检测),会压缩执行文件(Windows系统中的DLL也会)(参见note)
-o DIR, –out=DIR	指定spec文件的生成目录,如果没有指定,而且当前目录是PyInstaller的根目录,会自动创建一个用于输出(spec和生成的可执行文件)的目录.如果没有指定,而当前目录不是PyInstaller的根目录,则会输出到当前的目录下.
-p DIR, –path=DIR	设置导入路径(和使用PYTHONPATH效果相似).可以用路径分割符(Windows使用分号,Linux使用冒号)分割,指定多个目录.也可以使用多个-p参数来设置多个导入路径
–icon=<FILE.ICO>	将file.ico添加为可执行文件的资源(只对Windows系统有效)
–icon=<FILE.EXE,N>	将file.exe的第n个图标添加为可执行文件的资源(只对Windows系统有效)
-v FILE, –version=FILE	将verfile作为可执行文件的版本资源(只对Windows系统有效)
-n NAME, –name=NAME	可选的项目(产生的spec的)名字.如果省略,第一个脚本的主文件名将作为spec的名字