快捷導(dǎo)航

PyInstaller打包Python腳本的使用示例

更新時(shí)間：2025年04月30日 09:32:53 作者：Tiandaren

本文主要介紹了PyInstaller打包Python腳本的使用示例,通過(guò)?PyInstaller,可以將Python腳本打包成?.exe文件（適用于?Windows）或適用于?macOS?和?Linux?的可執(zhí)行文件,感興趣的可以了解一下

1. 寫(xiě)在前面

通常，在用 Python 編寫(xiě)完一個(gè)腳本后，需要將它部署并集成到一個(gè)更大的項(xiàng)目中。常見(jiàn)的集成方式有以下幾種：

使用 PyInstaller 打包。
使用 Docker 打包。
將 Python 嵌入到 C++ 代碼中，并封裝成類(lèi)。
將 Python 代碼轉(zhuǎn)換為 C++ 代碼。

本文介紹其中一種方式——使用 PyInstaller 打包。通過(guò) PyInstaller，可以將 Python 腳本打包成 .exe 文件（適用于 Windows）或適用于 macOS 和 Linux 的可執(zhí)行文件，用戶無(wú)需安裝 Python 或任何相關(guān)依賴(lài)，便能直接運(yùn)行程序。

主要優(yōu)勢(shì)：

將 Python 腳本打包成獨(dú)立可執(zhí)行文件，方便分發(fā)和運(yùn)行。
支持單文件打包、圖標(biāo)定制、以及額外文件的捆綁。
可選隱藏控制臺(tái)窗口，適合圖形化應(yīng)用（GUI）程序。

適用場(chǎng)景：

發(fā)布桌面工具或命令行程序。
讓沒(méi)有 Python 環(huán)境的用戶也能使用你的工具。
分享自包含的 Python 項(xiàng)目，確保目標(biāo)機(jī)器能夠順利運(yùn)行。

2. 打包指令解析與參數(shù)詳解

參數(shù)名	描述	示例	類(lèi)型	必須	默認(rèn)值
--onefile	將所有依賴(lài)文件打包為單個(gè)可執(zhí)行文件。	pyinstaller --onefile example.py	bool	否	False
--noconsole	隱藏控制臺(tái)窗口（適用于 GUI 應(yīng)用）。	pyinstaller --noconsole gui_app.py	bool	否	False
--name	指定生成的可執(zhí)行文件名稱(chēng)。	pyinstaller --name=my_app example.py	str	否	源文件名（無(wú)擴(kuò)展）
--icon	設(shè)置可執(zhí)行文件的圖標(biāo)（需提供 .ico 文件）。	pyinstaller --icon=app_icon.ico example.py	str	否	None
--add-data	捆綁額外文件（如配置文件、靜態(tài)資源等）。	pyinstaller --add-data "config.yaml;." example.py	str	否	None
--clean	清理之前的構(gòu)建緩存，強(qiáng)制重新打包。	pyinstaller --clean example.py	bool	否	False
--hidden-import	手動(dòng)添加隱藏的依賴(lài)模塊（通常是自動(dòng)檢測(cè)遺漏的依賴(lài)）。	pyinstaller --hidden-import=requests example.py	list	否	自動(dòng)檢測(cè)

3. 基礎(chǔ)步驟

1. 安裝 PyInstaller

在終端（或命令行）中運(yùn)行以下命令，安裝 PyInstaller：

pip install pyinstaller

2. 使用基礎(chǔ)命令進(jìn)行打包

假設(shè)你有一個(gè) Python 腳本 example_script.py，使用下面的命令將其打包為一個(gè)獨(dú)立的可執(zhí)行文件：

pyinstaller --onefile example_script.py

該命令會(huì)將所有依賴(lài)項(xiàng)和代碼打包成一個(gè)單一的 .exe 文件。
打包后，可以在 dist 目錄下找到生成的可執(zhí)行文件。

4. 常見(jiàn)的用法示例

示例 1：基礎(chǔ)打包

將 example_script.py 打包為一個(gè)單文件可執(zhí)行程序：

pyinstaller --onefile example_script.py

示例 2：自定義名稱(chēng)和圖標(biāo)

將輸出文件命名為 my_program.exe，并指定圖標(biāo)文件為 app_icon.ico：

pyinstaller --onefile --name=my_program --icon=app_icon.ico example_script.py

示例 3：捆綁額外文件

將配置文件 config.yaml 一起捆綁進(jìn)可執(zhí)行文件：

pyinstaller --onefile --add-data "config.yaml;." example_script.py

注意：在 Windows 系統(tǒng)中，路徑分隔符用分號(hào) ;，而在 macOS/Linux 中使用冒號(hào) :。

示例 4：解決缺失依賴(lài)問(wèn)題

如果在運(yùn)行時(shí)遇到某個(gè)模塊丟失的錯(cuò)誤，可以通過(guò) --hidden-import 指定手動(dòng)引入依賴(lài)：

pyinstaller --onefile --hidden-import=requests example_script.py

示例 5：隱藏控制臺(tái)窗口

適用于圖形界面（GUI）應(yīng)用程序，運(yùn)行時(shí)隱藏控制臺(tái)窗口：

pyinstaller --onefile --noconsole gui_app.py

5. 注意事項(xiàng)（路徑）

路徑問(wèn)題：使用 --add-data 時(shí)，不同操作系統(tǒng)的路徑分隔符需特別注意。
- Windows："source;destination"
- macOS/Linux："source:destination"
文件路徑問(wèn)題：在代碼中訪問(wèn)本地文件時(shí)，使用相對(duì)路徑獲取的文件可能會(huì)在打包后無(wú)法找到。此時(shí)，建議使用以下方式獲取正確的文件路徑：

BASE_DIR = os.path.dirname(os.path.realpath(sys.argv[0]))

6. 錯(cuò)誤處理和日志記錄

在打包的 Python 應(yīng)用中，為了方便調(diào)試，可以加入錯(cuò)誤處理代碼，將錯(cuò)誤信息記錄到文件中，幫助定位問(wèn)題。

try:
    # 代碼邏輯
    pass
except Exception as e:
    print("An error occurred:", e)
    with open("error_log.txt", "w") as f:
        f.write(str(e))

如果可執(zhí)行文件出現(xiàn)問(wèn)題，能夠在 error_log.txt 中查看詳細(xì)的錯(cuò)誤信息。

例如，

在這里插入圖片描述

這就是一個(gè)文件路徑錯(cuò)誤的報(bào)錯(cuò)，原因在于生成的可執(zhí)行文件是在 dist 目錄下，但是文件路徑是相對(duì)路徑，在 ../ 上，知道問(wèn)題就可以解決了。否則，有時(shí)候連報(bào)錯(cuò)都不知道在哪。

另外，如果想要更加優(yōu)雅地打包python，建議配合以下教程食用：
Python 參數(shù)配置使用 XML 文件的教程：輕松管理你的項(xiàng)目配置

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

您可能感興趣的文章:

最新国产好看的视频,伊人天堂AV在线,国产Aaaaaa视频,蜜臀视频在线观看一区,人妻av色图,密臀久久久精品影片,青青视频免费观看毛片,久草在线观看视,国产三级精品色情在线