Python 打包 Exe 程序避坑指南
本文轉載自微信公眾號「Python中文社區」，作者楊炳。轉載本文請聯系Python中文社區公眾號。
寫完一個python程序之后，如何才能快速地將代碼分享給別人，尤其對于初學者來說，能把自己的代碼包裝成一個exe程序并傳遞到別人電腦上運行，那是一件非常有成就感的事。好在python自帶簡易打包程序，讓很多人能過一把當程序員的癮。目前流行的打包庫就有py2exe、pyinstaller和cx_Freeze。
但python的運行環境復雜，編寫的程序往往是借助了很多附加的功能庫來實現，對簡單的打包會造成一定困難。本人也是在經歷了多次的打包失敗和成功的經歷之后，覺得pyinstaller的成功率最高，所以有必要針對pyinstaller寫一篇避坑指南。
一、安裝
使用python的pip安裝，在cmd窗口，使用pip install pyinstaller，即安裝完成。然后配置好環境變量。
二、使用
例如在程序6.py所在文件夾打開cmd窗口。一般輸入pyintaller -F **.py(命令符的具體含義在下文中解釋)，回車即開始打包。順利的話，會出現打包成功的反饋，如下圖，這時，就說明文件已經打包完成了。dist文件夾里面就放著打包完的exe程序，使用時剪切出來就行了。如果運氣好或者本身程序比較簡單，那這個exe就能在任何電腦運行了。
但往往沒這么容易，pyinstaller在使用中有很多坑，打包的開始，也是修補的開始。
三、遇坑填坑
1.文件路徑中不能出現中文
否則會在打包過程中直接出現如下報錯。這時只要把所在文件夾和程序名字改成英文或者數字重新打包即可。可以打包完再將exe的名字改回來。
2.缺少導入hook文件
有時即使打包成功了，在運行exe時候，還是會有報錯并閃退。
如果報錯為：FileNotFoundError: [Errno 2] No such file or directory:……
那是缺少hook文件，要在pyinstaller的安裝路徑里的hook增加一個自定義的hook。hook文件的命名規范為: hook-【庫名】.py。例如以我在打包程序中用了結巴分詞這個功能庫為例，那我要建立一個hook-jieba.py，并寫入：
- from PyInstaller.utils.hooks import collect_data_files
- datas = collect_data_files("jieba")
然后放到~\Lib\site-packages\PyInstaller\hooks中去，再次運行pyinstaller打包既可解決該問題。
3.缺少導入功能庫模塊
如果報錯為 no moduler named “pandas._libs.skiplist”，那就要手動import庫，解決方法打開生成的spec文件，找到 hiddenimports=[],加上要添加的庫，將其改動如下，hiddenimports=["pandas._libs.skiplist"]，然后刪除dist里面的exe文件，重新用spec文件打包，pyinstaller **.spec。即可解決該問題。
四、花式打包
涉及到打包的幾個重要參數如下。
- -F，將所有內容打包到一個exe中，方便發送，一般都使用這個參數。
- -c，此為windows系統的默認選項，使用這個參數，運行時會有一個黑窗控制臺。
- -w，使用這個參數，運行時不會出現黑窗控制臺。
- -i 使用這個參數用于生成自定義圖標的exe，在這后面要加上ico圖片的地址。例如，pyinstaller -i D:\icons\demo.ico **.py
五、結語
將程序打包成exe發送出去或者供用戶下載，是一個比較傳統的傳播方式，并且比較笨重，其實用簡單的H5或者小程序就能實現一樣的效果，對用戶而言也更方便，也是朝著輕應用的方向發展。此外，對于專業用戶還能通過github和api等方式傳播。隨著網絡觀念的深入人心和5G時代到來，相信有更好的方式能更安全、快捷、私密地將工具的功能傳遞給所需要的用戶。
作者：楊炳，心理學者在銀行寫代碼。
