在 PyCharm 中使用 PyInstaller 打包 EXE 之过程简记

背景

  1. Python 3.7.7
  2. PyCharm 2019.1.1
  3. PyInstaller 4.10

约定

  1. 下文把工程文件夹暂且称为“入口点目录”(即存放 venv 的目录)

  2. 如果 Terminal 未处于该目录,则需将 Terminal 也进入到该目录。例如:Terminal 目前处于 my_project\venv\Scripts\ ,则应执行 cd ..\.. 退回到 my_project\(即“入口点目录”)

    Microsoft Windows [版本 10.0.19043.1415]
    (c) Microsoft Corporation。保留所有权利。
    
    (venv) C:\Users\Administrator\Desktop\my_project\venv\Scripts>cd ..\..
    
    (venv) C:\Users\Administrator\Desktop\my_project>
    
  3. 假设程序入口点所在文件 main.py 也位于“入口点目录”中(如果不在,后续参数中对应修改为实际位置即可)

过程

1) 安装 PyInstaller

在 PyCharm 的 Terminal 执行:

pip install pyinstaller

2) 放入 UPX(此步可选)

用于减小 exe 文件大小。
https://github.com/upx/upx/releases 下载解压后,把 upx.exe 放到“入口点目录”。

注:由于 Python 本身的特点,哪怕只有一句 print('Hello world!'),压缩打包后也在 4.51M 左右,难以再小了。

3) 放入图标文件(此步可选)

Ico 格式,放到“入口点目录”。
假设文件名为 app.ico

4) 打包

在 PyCharm 的 Terminal 执行:

pyinstaller -F -i app.ico main.py

注1:如果在不是第一次打包时,打包过程容易莫名其妙终止,还报 succeed,可以通过先手动删除“入口点目录”下的 build\main 文件夹和 dist\main.exe__pycache__\main.cpython-3*.pyc 后再打包来解决。

注2:常用参数及说明:

pyinstaller [-F|-D] [options] <entry>

必要参数:

扫描二维码关注公众号,回复: 14645094 查看本文章
-F 打包成单文件
-D 按文件夹打包
<entry> 入口点文件

可选参数:

options:
-i <icon_file> 启用图标及图标文件
[-c|-w]
-c 以控制台运行
-w 以窗口运行

要参见更多参数,在 PyCharm 的 Terminal 执行:

pyinstaller

5) EXE 输出

位于“入口点目录”中的 dist 文件夹下。

注:不要到 build 文件夹去找,它只是个临时目录(受其他语言或开发环境影响容易习惯性地进到这里)。

6) 试运行

双击运行打包完的 exe,初次打包不一定能成功运行。

如果闪退,就在 cmd 里运行它,就不闪退了。通常是因为缺少某些模块导致的,缺少者也会在 cmd 中报出,对应在 PyCharm 中安装,再重新打包就行了(重复从 4 开始的步骤)。

7) 善后工作

把 exe 拷贝到一个单独目录,作为产品目录。现在,生成的 exe 和 main.py 是等价的。若 main.py 有依赖文件,则也需要拷贝过来,并保持目录结构;若 main.py 有运行时产生的文件,则它们也会相对 exe 所在位置而产生。

猜你喜欢

转载自blog.csdn.net/xzqsr2011/article/details/124114181