背景

在python工程完成開發(fā)以后需要編譯成可執(zhí)行文件，如此一來生產(chǎn)環(huán)境和開發(fā)環(huán)境隔離開來便于用戶使用（可獨立使用，無需配置python開發(fā)環(huán)境），pyinstaller可以方便地將腳本編譯成exe

1. pyinstaller的安裝

pip install pyinstaller

2. pyinstaller工作原理

• 先生成一個spec文件（手動或自動均可），該文件決定了實際編譯規(guī)則
• 再自動生成一個build文件夾，所有自動編譯的中間產(chǎn)物都放在其中
• 最后生成dist文件夾，存放編譯輸出

3. pyinstaller打包成exe

3.1 最簡單（單個文件）：

pyinstaller xxx.py

一般搞法（多文件）

• 先自動生成spec文件： pyi-makespec xxx.py
• 再根據(jù)自己的實際需求手動修改spec文件
• 最后統(tǒng)一installer： pyinstaller xxx.spec

F 生成一個單一可執(zhí)行文件【常用】

w 禁止彈出控制臺【常用】

i 修改exe生成的圖標【常用】

h 打印幫助信息

v 打印版本信息

d 生成帶各種依賴的文件夾，包含exe，dll,以及其他文件

p 指定搜索路徑

3.3 spec文件解析

Analysis: 
    ['Console.py','xxx.py'...] <- 此處列出的腳本生成exe后會按順序依次執(zhí)行！
    pathex <- 此處為搜索路徑
    binaries <- 非python的庫文件
    datas <- ini文件，字體，圖片，icon什么的
    pure <- python模塊
PYZ: <- 不用管
EXE: <- 輸出配置
COLLECT: <- 不用管

3.4 打包dll

在生成的spec文件中修改datas字段，形如：

3.5 利用upx壓縮exe

UPX下載地址

運行命令： pyinstaller xxx.spec --upx [輸出路徑]

4. 常見問題

4.1 打包后的文件太大了

方法1 —— 虛擬環(huán)境下打包

造成打包文件太大的主要原因是打包了太多不必要的庫，比如安裝了anaconda。或者自己pip install了太多庫。顯然要想解決該問題核心就是不要打包那么多的庫。

最好的辦法是：在一個虛擬環(huán)境中單獨打包，只打包該程序執(zhí)行所必備的依賴庫

具體操作方法是：

• 先安裝 pipenv工具，在該工具的幫助下創(chuàng)建虛擬環(huán)境單獨打包

pip install pipenv

• 進入虛擬環(huán)境：

pipenv shell

• 嘗試運行一下應(yīng)用程序，缺什么包就單獨pip install安裝什么包

python xxx.py

• 當(dāng)前面的應(yīng)用程序都可以用的時候再安裝pyinstaller，然后進行打包即可

pip install pyinstaller ,pyinstaller -Fw xxx.py

• 退出虛擬環(huán)境

exit

關(guān)于pipenv更詳細使用請參閱

方法2 —— 排除不相干的包

在*.spec的excludes欄目中添加對應(yīng)的， 常見： excludes=['matplotlib', 'pandas', 'scipy'],

也可以通過命令行排除： pyinstaller.exe --exclude xxx_package yyy.py

4.2 明明python xxx.py能正常使用， 而打包成exe卻無法使用了

主要有以下幾種現(xiàn)象：

• 編譯后的exe在打包的機器上運行良好，放到別人機器上不能用了。
• python xxx.py能正常使用， 而打包成exe卻無法使用了。

目前所知主要是兩個方面的原因：

• 路徑問題。
• 依賴包的問題。

python腳本執(zhí)行的默認路徑和exe打包后的路徑是不一樣的，如果軟件中存在文件讀取等操作，很有可能導(dǎo)致exe找不到資源而運行出錯。

解決該問題的方法是路徑凍結(jié)

#frozen_dir.py
import os,sys
def app_path():
    if hasattr(sys, 'frozen'):
        return os.path.dirname(sys.executable)
    return os.path.dirname(__file__)

添加frozen_dir.py后，app_path會生成一個絕對準確的基地址，所有的路徑以此為基準，如下所示：

import frozen_dir
SETUP_DIR = frozen_dir.app_path()

依賴包的問題往往出現(xiàn)在：在一開始就pyinstaller打包過程序，后續(xù)開發(fā)時又安裝了新模塊，如此一來python xxx.py可以正常執(zhí)行腳本，但是運行xxx.exe報錯。

錯誤根源可能是：pyinstaller是不會更新__pycache__文件夾的，所以后面增加的模塊它不知道，也不會打包進去的：

解決方法非常簡單：把打包中生成的資源全部刪除【__ pycache __, build, dist】，然后重新打包即可

4.3 打包后exe執(zhí)行速度太慢了啊

解決方法1：精簡代碼，刪除不必要的內(nèi)容

解決方法2： 用-D -w 打包，缺點是文件太多

pyinstaller -D -w -i icon.ico XX.py

FAQ A: -F打包成的exe可以用，帶上-w參數(shù)去掉console框就不能用了

Q：暫未解決（跟源碼中需要獲取cmd執(zhí)行輸出有關(guān)）

A：-i增加自定義icon功能后，目錄下不含icon資源exe執(zhí)行異常

Q：暫未解決

A： No module named pkg_resources

Q: 有可能是setuptools版本太高所致(請參考文末擴展知識)，pip install setuptools==44.0.0 即可

A：failed to execute pyi_rth_pkgres

Q: 有可能是pyinstaller的版本問題，卸載重新安裝一下，參考：

擴展：

Pyinstaller No module named pkg_resources.py2_warn

我通過降低setuptools版本到 44.0.0 后成功解決問題。

pip install  setuptools==44.0.0?

參考鏈接

pyinstaller踩坑指南

pyinstaller使用詳細教程

pyinstaller官網(wǎng)手冊

spec修改示例

py,pyc,pyo,pyd的講解，不同需求不同打包策略

Pyinstaller打包附帶DLL、圖標和壓縮EXE方法

到此這篇關(guān)于pyinstaller使用大全的文章就介紹到這了,更多相關(guān)pyinstaller使用內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評論