PyInstaller：将python源代码打包成exe可执行程序

旧城等待， 2023-10-05 20:59 34阅读 0赞

## 一、PyInstaller简介 ##

PyInstaller是一个第三方库，它能够在Windows、Linux、 Mac OS X 等操作系统下将 Python 源文件打包，通过对源文件打包， Python 程序可以在没有安装 Python 的环境中运行，也可以作为一个 独立文件方便传递和管理。

PyInstaller支持Python 2.7和Python 3.3+。可以在Windows、Mac OS X和Linux上使用，但是并不是跨平台的，而是说你要是希望打包成.exe文件，需要在Windows系统上运行PyInstaller进行打包工作；打包成mac app，需要在Mac OS上使用。

安装与更新

pip/pip3 install pyinstaller

pip/pip3 install --upgrade pyinstalle

注意：

1.  PyInstaller 库会自动将 PyInstaller 命令安装到 Python 解释器 目录中，与 pip 或 pip3 命令路径相同，因此可以直接使用。
2.  Windows上运行PyInstaller还需要PyWin32或者pypiwin32，其中pypiwin32在你安装PyInstaller的时候会自动安装。

## 二、PyInstaller生成可执行程序 ##

PyInstaller 工具的命令语法如下：

pyinstaller 选项 Python 源文件

不管这个 Python 应用是单文件的应用，还是多文件的应用，只要在使用 pyinstaller 命令时编译作为程序入口的 Python 程序即可。

PyInstaller工具是跨平台的，它既可以在 Windows平台上使用，也可以在 Mac OS X 平台上运行。在不同的平台上使用 PyInstaller 工具的方法是一样的，它们支持的选项也是一样的。

下面先创建一个 app 目录，在该目录下创建一个 app.py 文件，文件中包含如下代码：

def main():
    	print('程序开始执行')
    
    if __name__ == '__main__':
    	main()

接下来使用命令行工具进入到此 app 目录下，执行如下命令：

pyinstaller -F app.py

执行上面命令，将看到详细的生成过程。当生成完成后，将会在此 app 目录下看到多了一个 dist 目录，并在该目录下看到有一个 app.exe 文件，这就是使用 PyInstaller 工具生成的 EXE 程序。

在命令行窗口中进入 dist 目录下，在该目录执行 app.exe ，

dist> ./app.exe

将会看到该程序生成如下输出结果：

程序开始执行

由于该程序没有图形用户界面，因此如果读者试图通过双击来运行该程序，则只能看到程序窗口一闪就消失了，这样将无法看到该程序的输出结果。

在上面命令中使用了-F 选项，该选项指定生成单独的 EXE 文件，因此，在 dist 目录下生成了一个单独的大约为 6MB 的 app.exe 文件（在 Mac OS X 平台上生成的文件就叫 app，没有后缀）；与 -F 选项对应的是 -D 选项（默认选项），该选项指定生成一个目录（包含多个文件）来作为程序。

下面先将 PyInstaller 工具在 app 目录下生成的 build、dist 目录删除，并将 app.spec 文件也删除，然后使用如下命令来生成 EXE 文件。

pyinstaller -D app.py

执行上面命令，将看到详细的生成过程。当生成完成后，将会在 app 目录下看到多了一个 dist 目录，并在该目录下看到有一个 app 子目录，在该子目录下包含了大量 .dll 文件和 .pyz 文件，它们都是 app.exe 程序的支撑文件。在命令行窗口中运行该 app.exe 程序，同样可以看到与前一个 app.exe 程序相同的输出结果。

PyInstaller 不仅支持 -F、-D 选项，而且也支持如表 1 所示的常用选项。

<table> 
 <thead> 
  <tr> 
   <th>-h，–help</th> 
   <th>查看该模块的帮助信息</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>-F，-onefile</td> 
   <td>产生单个的可执行文件</td> 
  </tr> 
  <tr> 
   <td>-D，–onedir</td> 
   <td>产生一个目录（包含多个文件）作为可执行程序</td> 
  </tr> 
  <tr> 
   <td>-a，–ascii</td> 
   <td>不包含 Unicode 字符集支持</td> 
  </tr> 
  <tr> 
   <td>-d，–debug</td> 
   <td>产生 debug 版本的可执行文件</td> 
  </tr> 
  <tr> 
   <td>-w，–windowed，–noconsolc</td> 
   <td>指定程序运行时不显示命令行窗口（仅对 Windows 有效）</td> 
  </tr> 
  <tr> 
   <td>-c，–nowindowed，–console</td> 
   <td>指定使用命令行窗口运行程序（仅对 Windows 有效）</td> 
  </tr> 
  <tr> 
   <td>-o DIR，–out=DIR</td> 
   <td>指定 spec 文件的生成目录。如果没有指定，则默认使用当前目录来生成 spec 文件</td> 
  </tr> 
  <tr> 
   <td>-p DIR，–path=DIR</td> 
   <td>设置 Python 导入模块的路径（和设置 PYTHONPATH 环境变量的作用相似）。也可使用路径分隔符（Windows 使用分号，Linux 使用冒号）来分隔多个路径</td> 
  </tr> 
  <tr> 
   <td>-n NAME，–name=NAME</td> 
   <td>指定项目（产生的 spec）名字。如果省略该选项，那么第一个脚本的主文件名将作为 spec 的名字</td> 
  </tr> 
 </tbody> 
</table>