快捷導(dǎo)航

python文件打包方式(使用pyinstaller)

更新時(shí)間：2026年06月03日 08:35:15 作者：安生生申

這段描述主要介紹了PyInstaller的使用方法,包括如何通過pip安裝PyInstaller,如何使用簡(jiǎn)單命令和復(fù)雜命令進(jìn)行打包,以及如何通過編寫打包腳本進(jìn)行操作,同時(shí)提到了在打包過程中可能出現(xiàn)的PIL模塊錯(cuò)誤,并提供了相應(yīng)的解決方法

安裝

使用pip命令來安裝PyInstaller。在終端或命令提示符中運(yùn)行以下命令：

打包

先安裝所有需要的依賴

?pip install -r .\requirements.txt

方式一：使用打包命令

簡(jiǎn)單命令：

pyinstaller main.py

復(fù)雜命令：

Window - Powershell：

pyinstaller -n SnakeGame `
        -i img/icon.png `
		--clean --onedir `
    	--windowed `
		--add-data="img;img" `
		--exclude-module="numpy" `
		main.py

Window - cmd：

# 打包到一個(gè)目錄
pyinstaller -n PID_Tool -i img/logo.ico ^
		--clean --onedir	 ^
		--add-data="res;res" ^
		--add-data="img;img" ^
		--exclude-module="matplotlib" ^
		app.py

Linux/Mac：

# 打包成單文件
pyinstaller -n PID_Tool -i img/logo.ico \
		--clean --onefile	 \
		--add-data="res:res" \
		--add-data="img:img" \
		--exclude-module="matplotlib" \
		main.py

方式二：編寫打包腳本

假如你的程序名稱為PID_GUI_Tool，程序入口文件為main.py，則在入口文件同級(jí)目錄創(chuàng)建一個(gè)package.py，寫入如下內(nèi)容

import PyInstaller.__main__

# 這里的是不需要打包進(jìn)去的三方模塊，可以減少軟件包的體積
excluded_modules = [
    "scipy",
    "matplotlib",
]

append_string = []
for mod in excluded_modules:
    append_string += [f'--exclude-module={mod}']

PyInstaller.__main__.run([
    '-y',  # 如果dist文件夾內(nèi)已經(jīng)存在生成文件，則不詢問用戶，直接覆蓋
    # '-p', 'src', # 設(shè)置 Python 導(dǎo)入模塊的路徑（和設(shè)置 PYTHONPATH 環(huán)境變量的作用相似）。也可使用路徑分隔符（Windows 使用分號(hào);，Linux 使用冒號(hào):）來分隔多個(gè)路徑
    'main.py',  # 主程序入口
    '--onedir',  # -D 文件夾
    # '--onefile', # -F 單文件
    # '--nowindowed', # -c 無窗口
    '--windowed',  # -w 有窗口
    '-n', 'PID_GUI_Tool',
    '-i', 'img/logo.ico',
    '--add-data=res;res',  # 用法：pyinstaller main.py –add-data=src;dest。windows以;分割，mac,linux以:分割
    '--add-data=img;img',  # 用法：pyinstaller main.py –add-data=src;dest。windows以;分割，mac,linux以:分割
    *append_string
])

執(zhí)行python package.py或直接在編輯器中運(yùn)行即可。

打好包，可執(zhí)行程序在同級(jí)目錄的dist子目錄即可找到