Python 打包 EXE 工具橫評：PyInstaller、cx_Freeze、py2exe 深度解析

引言

Python 開發的腳本需依賴特定環境運行，這限制了程序的分發效率。將腳本打包為獨立可執行文件（EXE）成為關鍵解決方案。本文針對三大主流工具——PyInstaller、cx_Freeze 和 py2exe，從易用性、兼容性、功能特性和生成效率四大維度進行實測對比，助您精準選擇。

一、工具核心特性概覽

二、實測對比：四大關鍵維度

1. 易用性

• PyInstaller
  單命令完成打包：

pyinstaller --onefile script.py

• cx_Freeze
  需編寫 setup.py 配置文件：

from cx_Freeze import setup, Executable  
setup(executables=[Executable("script.py")])

• py2exe
  基礎配置簡單：

from distutils.core import setup  
import py2exe  
setup(console=["script.py"])

評分：PyInstaller ★★★★☆ | cx_Freeze ★★★☆☆ | py2exe ★★★★☆

2. 兼容性

• 操作系統

• PyInstaller：支持 Windows/Linux/macOS
• cx_Freeze：全平台兼容
• py2exe：僅限 Windows

• Python 版本
  PyInstaller 對 Python 3.6+ 支持最佳；cx_Freeze 兼容 3.5+；py2exe 僅兼容 Python 3.x 以下版本。

評分：cx_Freeze ★★★★★ | PyInstaller ★★★★☆ | py2exe ★★☆☆☆

3. 生成效率

對同一腳本（含 NumPy、Pandas 依賴）打包測試：

結論：cx_Freeze 在體積優化上表現最佳；PyInstaller 啓動速度領先。

4. 高級功能

• 加密保護：僅 PyInstaller 支持通過 --key 參數進行字節碼加密。
• 依賴排除：cx_Freeze 可手動剔除無用庫，顯著減小體積。
• 界面隱藏：py2exe 支持後台運行（windows=["script.py"]）。

三、典型問題解決方案

1. 依賴缺失

• PyInstaller：使用 --hidden-import 手動添加缺失模塊。
• cx_Freeze：在 setup.py 中配置 packages 列表。

2. 殺毒軟件誤報
   三大工具均可能觸發誤報，推薦：

• 使用代碼簽名證書
• 提交至 VirusTotal 加白名單

3. 路徑問題
   通用方案：

import sys, os  
if getattr(sys, 'frozen', False):  
    BASE_DIR = os.path.dirname(sys.executable)  
else:  
    BASE_DIR = os.path.dirname(__file__)

四、選型建議

• 優先 PyInstaller：適合快速打包跨平台應用，尤其開源項目。
• 選擇 cx_Freeze：企業級複雜項目需精細控制依賴時。
• 慎用 py2exe：僅推薦舊版 Windows 遺留系統維護。

避坑提示：

• 避免打包 TensorFlow/PyTorch 等大型庫，推薦改用 Docker 分發
• 資源文件（如圖片）需手動複製到生成目錄

結語

PyInstaller 以“開箱即用”成為多數場景首選；cx_Freeze 憑藉可定製性勝任複雜需求；py2exe 因兼容性侷限逐漸邊緣化。實際選型應結合目標平台、依賴複雜度及維護成本綜合考量。技術決策的本質，是在工具約束與需求之間尋找最優解。