PyInstaller将Python打包成windows可执行的exe(细致版)
6人参与 • 2026-01-31 • Python
在开发 python 应用程序时，有时我们需要将脚本打包成独立的可执行文件（.exe），以便于在没有安装 python 环境的计算机上运行。本文将介绍如何使用 pyinstaller 工具将 python 本打包成 windows 可执行文件。
1. 安装 pyinstaller
首先，你需要安装 pyinstaller。可以通过 pip 来安装：
pip install pyinstaller
2. 准备你的 python 脚本
假设你有一个名为 myapp.py 的 python 脚本，内容如下：
import tkinter as tk
def on_button_click():
label.config(text="hello, world!")
root = tk.tk()
root.title("my app")
label = tk.label(root, text="welcome to my app")
label.pack(pady=20)
button = tk.button(root, text="click me", command=on_button_click)
button.pack(pady=10)
root.mainloop()这个脚本使用 tkinter 库创建了一个简单的 gui 应用程序。
3. 使用 pyinstaller 打包脚本
3.1 基本打包
打开命令行或终端，导航到包含 myapp.py 的目录，然后运行以下命令：
pyinstaller myapp.py
这将生成一个 dist 目录，其中包含可执行文件和其他必要的文件。
3.2 单文件模式
为了生成一个单独的可执行文件，可以使用 --onefile 参数：
pyinstaller --onefile myapp.py
3.3 设置图标
如果你希望给生成的可执行文件设置图标，可以使用 --icon 参数。假设你有一个名为 myicon.ico 的图标文件：
pyinstaller --onefile --icon=myicon.ico myapp.py
3.4 隐藏控制台窗口
对于 gui 应用程序，你可能不希望显示控制台窗口。可以使用 --noconsole 参数来隐藏控制台窗口：
pyinstaller --onefile --noconsole --icon=myicon.ico myapp.py
3.5 添加数据文件
如果你的应用程序需要额外的数据文件，比如配置文件或资源文件，可以使用 --add-data 参数。例如，假设你有一个名为 config.ini 的配置文件：
pyinstaller --onefile --noconsole --icon=myicon.ico --add-data "config.ini;." myapp.py
这里的 config.ini;. 表示将 config.ini 文件复制到可执行文件所在目录的根目录下。
4. 使用 .spec 文件进行高级配置
对于更复杂的项目，你可能需要更多的控制权。pyinstaller 提供了 .spec 文件来配置构建过程。
4.1 生成 .spec 文件
首次运行 pyinstaller 时，它会自动生成一个 .spec 文件。例如：
pyinstaller myapp.py
这将在当前目录下生成一个 myapp.spec 文件。
4.2 编辑 .spec 文件
打开 myapp.spec 文件，你可以看到类似以下内容：
# -*- mode: python ; coding: utf-8 -*-
block_cipher = none
a = analysis(
['myapp.py'],
pathex=[],
binaries=[],
datas=[],
hiddenimports=[],
hookspath=[],
runtime_hooks=[],
excludes=[],
win_no_prefer_redirects=false,
win_private_assemblies=false,
cipher=block_cipher,
)
pyz = pyz(a.pure, a.zipped_data,
cipher=block_cipher)
exe = exe(
pyz,
a.scripts,
[],
exclude_binaries=true,
name='myapp',
debug=false,
strip=false,
upx=true,
console=false,
icon='myicon.ico',
)
coll = collect(
exe,
a.binaries,
a.zipfiles,
a.datas,
strip=false,
upx=true,
upx_exclude=[],
name='myapp',
)你可以在这个文件中进行各种配置，例如添加数据文件、排除不必要的模块等。
4.3 使用 .spec 文件构建
保存并关闭 .spec 文件后，使用以下命令进行构建：
pyinstaller myapp.spec
5.创建虚拟环境，减少打包文件文件大小
一般打包时，会将一些不必要的库顺带一并打包进程序中，这会造成打包后的文件非常大，因此可以通过安装一个虚拟环境来进行打包。
复制这个目录。
然后，我们需要安装两个依赖包：
pip install virtualenv pip install virtualenvwrapper-win
如果网络不佳，可使用国内的镜像库进行安装：
pip install virtualenv -i https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple some-package
然后创建虚拟环境：
mkvirtualenv -p="c:\users\jyw\appdata\local\programs\python\python311\python.exe" pyenv311
打开这个虚拟环境：
workon pyenv311
可以看到里面只有基本的库。
然后我们去运行py文件，安装缺失的必要库，运行成功后再打包即可。
若要删除虚拟环境，使用 rmvirtualenv 命令删除虚拟环境：例如，要删除名为 pyenv311 的虚拟环境，可以运行以下命令：
rmvirtualenv pyenv311
6. 测试生成的可执行文件
构建完成后，进入 dist 目录，运行生成的可执行文件：
cd dist myapp.exe
确保应用程序能够正常运行，并且所有功能都能正常使用。
7. 分发可执行文件
将 dist 目录中的可执行文件及其依赖文件（如果有）打包成一个压缩包，发给需要用的人即可啦！！
到此这篇关于pyinstaller将python打包成windows可执行的exe(细致版)的文章就介绍到这了,更多相关pyinstaller打包python内容请搜索代码网以前的文章或继续浏览下面的相关文章希望大家以后多多支持代码网！
赞 (0)
您想发表意见！！点此发布评论
发表评论