PyInstaller将Python打包成windows可执行的exe(细致版)

 更新时间:2026年01月31日 09:42:16   作者:小软件大世界  
在开发 Python 应用程序时,有时我们需要将脚本打包成独立的可执行文件(.exe),下面小编就来和大家详细介绍一下具体步骤,有需要的小伙伴可以了解下

在开发 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内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • 在Python中存储字符串

    在Python中存储字符串

    这篇文章主要介绍了在Python中存储字符串,文章通过unicode展开主题相关内容,具有一定的参考价值,需要的小伙伴可以参考一下
    2022-05-05
  • python计算机视觉实现全景图像拼接示例

    python计算机视觉实现全景图像拼接示例

    这篇文章主要为大家介绍了python计算机视觉实现全景图像拼接示例详解,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2022-05-05
  • python中的全局变量与局部变量解读

    python中的全局变量与局部变量解读

    这篇文章主要介绍了python中的全局变量与局部变量用法,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2024-06-06
  • Python 中10进制数与16进制数相互转换问题

    Python 中10进制数与16进制数相互转换问题

    这篇文章主要介绍了Python中10进制数与16进制数相互转换,在Python中,我们可以使用内置的hex()函数将10进制数转换为16进制数,需要的朋友可以参考下
    2023-05-05
  • Python基础之numpy库的使用

    Python基础之numpy库的使用

    这篇文章主要介绍了Python基础之numpy库的使用,文中有非常详细的代码示例,对正在学习python基础的小伙伴们有非常好的帮助,需要的朋友可以参考下
    2021-04-04
  • Python 文件操作方法总结

    Python 文件操作方法总结

    这篇文章主要介绍了Python 文件操作方法总结,文章基于python的基础展开Python 文件操作方法,具有一定的参考价值,需要的小伙伴可以参考一下
    2022-05-05
  • Python通过跳板机访问数据库的方法

    Python通过跳板机访问数据库的方法

    跳板机是一类可作为跳板批量操作的远程设备的网络设备,是系统管理员和运维人员常用的操作平台之一。本文给大家介绍Python通过跳板机访问数据库的方法,感兴趣的朋友跟随小编一起看看吧
    2021-10-10
  • 50行Python代码带你打造一个桌面AI Agent

    50行Python代码带你打造一个桌面AI Agent

    近期热榜都被 OpenClaw 刷屏了,但桌面 Agent 的核心原理就是截图-看图-操作循环,使用 pyautogui+ Vision API,50 行 Python就能造一个能用的桌面 Agent,下面小编就和大家详细介绍一下吧
    2026-03-03
  • Python中Dataframe元素为不定长list时的拆分分组

    Python中Dataframe元素为不定长list时的拆分分组

    本文主要介绍了Python中Dataframe元素为不定长list时的拆分分组,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2023-03-03
  • python检测某个变量是否有定义的方法

    python检测某个变量是否有定义的方法

    这篇文章主要介绍了python检测某个变量是否有定义的方法,实例分析了Python常用的变量判定技巧,需要的朋友可以参考下
    2015-05-05

最新评论