快捷導(dǎo)航

6種方法輕松實現(xiàn)將Python腳本打包成EXE應(yīng)用

更新時間：2025年12月17日 08:32:14 作者：幸福清風(fēng)

將?Python?代碼打包成獨立的可執(zhí)行文件是一個非常常見的需求,用戶無需任何額外環(huán)境配置,就能像運(yùn)行普通軟件一樣直接啟動您的?Python?應(yīng)用,下面小編就和大家介紹六種主流且有效的?Python?打包工具吧

引言

Python 憑借其簡潔的語法和強(qiáng)大的功能，在數(shù)據(jù)分析、Web 開發(fā)、自動化腳本等領(lǐng)域廣受歡迎。它“開箱即用”的特性讓開發(fā)者能夠快速構(gòu)建原型和應(yīng)用程序。然而，對于最終用戶而言，運(yùn)行 Python 腳本往往意味著需要預(yù)先安裝 Python 解釋器及相關(guān)依賴庫，這對非技術(shù)背景的用戶來說無疑增加了門檻。

為了解決這一問題，將 Python 代碼打包成獨立的可執(zhí)行文件（通常在 Windows 上是 .exe 文件）成為了一個非常實用的選擇。這樣，用戶無需任何額外環(huán)境配置，就能像運(yùn)行普通軟件一樣直接啟動您的 Python 應(yīng)用。本文將為您介紹六種主流且有效的 Python 打包工具，助您輕松實現(xiàn)跨平臺分發(fā)。

1.PyInstaller: 最流行的選擇

PyInstaller 是目前最廣為人知、社區(qū)支持最廣泛的 Python 打包工具之一。它能夠很好地處理各種復(fù)雜的依賴關(guān)系，并支持將整個應(yīng)用及其所需資源打包成一個或多個獨立的可執(zhí)行文件。

特點：

支持 Windows, Linux, macOS。
可以打包成單個文件或包含多個文件的目錄。
對大多數(shù) Python 包有良好的兼容性。

基本用法：在項目根目錄下打開終端或命令提示符，執(zhí)行以下命令即可開始打包：

pyinstaller your_script.py

默認(rèn)情況下，會在 dist/ 目錄下生成可執(zhí)行文件。添加 --onefile 參數(shù)可以打包成單個 exe 文件。

示例 app.py：

# app.py
import sys, json
from pathlib import Path

def resource_path(relative):
    base = getattr(sys, "_MEIPASS", Path(__file__).parent)  # onefile 下的臨時目錄
    return Path(base) / relative

def main():
    print("Hello PyInstaller!")
    cfg = json.loads(resource_path("data/config.json").read_text(encoding="utf-8"))
    print("config:", cfg)

if __name__ == "__main__":
    main()

準(zhǔn)備數(shù)據(jù)文件：data/config.json

{"app_name":"Hello","debug":true}

打包（單文件）：

pyinstaller -F -n hello `
  --add-data "data\config.json;data" `
  app.py

Windows 的 --add-data 使用分號 ;（Linux/macOS 用冒號 :）。
輸出目錄：dist/hello.exe（成品）、build/（臨時）、hello.spec（構(gòu)建配置）。

2. cx_Freeze : 跨平臺的老牌選手

cx_Freeze 是一個老牌的跨平臺打包工具，同樣支持將 Python 程序轉(zhuǎn)換為 Windows、macOS 和 Linux 下的原生可執(zhí)行文件。

特點：

高度跨平臺。
配置相對靈活。

基本用法：通過命令行直接打包：

cxfreeze your_script.py --target-dir dist

這會將生成的可執(zhí)行文件及相關(guān)依賴放入 dist 目錄中。

示例：

編寫setup.py

要使用cx_Freeze打包Python腳本，你需要編寫一個setup.py文件，該文件告訴cx_Freeze如何打包你的程序。以下是一個基本的setup.py示例：

from cx_Freeze import setup, Executable

# 要打包的Python腳本路徑
script = "main.py"

# 創(chuàng)建可執(zhí)行文件的配置
exe = Executable(
    script=script,
    base=None,  # 對于GUI應(yīng)用，可以設(shè)置為"Win32GUI"來隱藏控制臺窗口
    targetName="MyProgram"  # 生成的可執(zhí)行文件名稱
)

# 打包的參數(shù)配置
options = {
    "build_exe": {
        "packages": [],  # 需要打包的額外Python包列表
        "excludes": [],  # 不需要打包的Python包列表
        "include_files": [],  # 需要包含的文件或文件夾列表
        "include_msvcr": True  # 是否包含Microsoft Visual C++運(yùn)行時庫
    }
}

# 打包配置
setup(
    name="MyProgram",
    version="1.0",
    description="My Program Description",
    options=options,
    executables=[exe]
)

打包可執(zhí)行文件

在命令行（終端）中，運(yùn)行以下命令來打包你的Python腳本：

python setup.py build

執(zhí)行上述命令后，cx_Freeze會創(chuàng)建一個build文件夾，其中包含打包好的可執(zhí)行文件和所有必要的庫。

注意事項

打包時可能會因為缺少依賴庫而失敗，此時可以在options鍵下添加依賴庫來修復(fù)。
如果你的應(yīng)用是GUI應(yīng)用，并且不希望顯示控制臺窗口，可以將base參數(shù)設(shè)置為"Win32GUI"。

3.py2exe: Windows 平臺專用專家

顧名思義，py2exe 是專為 Windows 平臺設(shè)計的打包工具。如果您確定目標(biāo)用戶只使用 Windows 系統(tǒng)，那么 py2exe 是一個成熟穩(wěn)定的選擇。

特點：

專注于 Windows 平臺，針對該系統(tǒng)優(yōu)化良好。
歷史悠久，文檔和社區(qū)經(jīng)驗豐富。

基本用法： py2exe 通常需要配合一個 setup.py 腳本來進(jìn)行更精細(xì)的控制。最基本的打包方式是在 setup.py 中配置好選項后，運(yùn)行：

python setup.py py2exe

4.py2app: macOS 平臺的對應(yīng)方案

與 py2exe 類似，py2app 是專門為 macOS 設(shè)計的 Python 打包工具。

特點：

專為 macOS 優(yōu)化。
能夠創(chuàng)建符合 macOS 規(guī)范的應(yīng)用程序包 (.app)。

基本用法：同樣需要一個 setup.py 腳本。配置完成后，通過以下命令打包：

python setup.py py2app

5.Nuitka: 編譯加速，性能提升

Nuitka 不僅僅是一個打包工具，它首先是一個 Python 到 C++ 的編譯器。它可以將 Python 代碼先編譯成優(yōu)化過的 C++ 代碼，然后再鏈接成可執(zhí)行文件。這不僅能生成獨立的 exe，有時還能帶來一定的性能提升。

特點：

兼具打包和編譯功能。
可能提高部分程序的執(zhí)行速度。
支持多種操作系統(tǒng)。

基本用法：安裝后，直接對 Python 腳本進(jìn)行編譯打包：

nuitka --standalone your_script.py

--standalone 參數(shù)用于生成包含所有依賴的獨立文件夾。

6.Nuitka + PyInstaller: 強(qiáng)強(qiáng)聯(lián)合

這是一個進(jìn)階技巧，結(jié)合了 Nuitka 的編譯優(yōu)勢和 PyInstaller 的打包便利性。

思路：

使用 Nuitka 將 Python 腳本編譯成 C++ 代碼并生成可執(zhí)行文件（或模塊）。
再利用 PyInstaller 對 Nuitka 生成的結(jié)果進(jìn)行二次打包，進(jìn)一步優(yōu)化結(jié)構(gòu)或處理復(fù)雜依賴。

示例流程（簡化示意）：

# 第一步：用 Nuitka 生成獨立結(jié)構(gòu)
nuitka --standalone your_script.py

# 第二步：可能需要手動調(diào)整或使用 PyInstaller 處理特定需求
# 注意：這里的 `your_script.spec` 需要根據(jù)實際情況編寫或由 PyInstaller 生成并修改
# pyinstaller your_script.spec

注意: 這種組合使用較為復(fù)雜，通常用于對性能和打包結(jié)果有特殊要求的場景。PyInstaller 通?？梢灾苯犹幚砑?Python 項目，不一定需要 Nuitka 預(yù)編譯。