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中四个不常见的小技巧,文章围绕主题展开详细的内容介绍,具有一定的参考价值,需要的小伙伴可以参考一下
    2022-08-08
  • 基于Python自动化实现Word文档专业排版

    基于Python自动化实现Word文档专业排版

    在办公自动化领域,用 Python 处理 Word 文档已经是非常成熟和高效的方案了,本文将和大家使用Python实现自动化Word文档排版的相关知识,希望对大家有所帮助
    2026-05-05
  • python3.6环境安装+pip环境配置教程图文详解

    python3.6环境安装+pip环境配置教程图文详解

    这篇文章主要介绍了python3.6环境安装+pip环境配置教程图文详解,非常不错,具有一定的参考借鉴价值,需要的朋友可以参考下
    2019-06-06
  • Flask WTForms 表单插件的使用

    Flask WTForms 表单插件的使用

    本文主要介绍了Flask WTForms表单插件的使用,Python的WTForms库通过提供表单的结构、验证和渲染等功能,简化了表单的处理流程,感兴趣的可以了解一下
    2023-11-11
  • Python深度学习pytorch神经网络块的网络之VGG

    Python深度学习pytorch神经网络块的网络之VGG

    虽然AlexNet证明深层神经网络卓有成效,但它没有提供一个通用的模板来指导后续的研究人员设计新的网络。下面,我们将介绍一些常用于设计深层神经网络的启发式概念
    2021-10-10
  • Python 内置函数globals()和locals()对比详解

    Python 内置函数globals()和locals()对比详解

    这篇文章主要介绍了Python globals()和locals()对比详解,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
    2019-12-12
  • Python从零打造高安全密码管理器

    Python从零打造高安全密码管理器

    在数字化时代,每人平均需要管理近百个账号密码,本文将带大家深入剖析一个基于Python的高安全性密码管理器实现方案,感兴趣的小伙伴可以参考一下
    2025-04-04
  • python调用matlab的方法详解

    python调用matlab的方法详解

    这篇文章主要为大家介绍了python调用matlab,具有一定的参考价值,感兴趣的小伙伴们可以参考一下,希望能够给你带来帮助
    2021-11-11
  • python进阶之多线程对同一个全局变量的处理方法

    python进阶之多线程对同一个全局变量的处理方法

    今天小编就为大家分享一篇python进阶之多线程对同一个全局变量的处理方法,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2018-11-11
  • python内置数据类型之列表操作

    python内置数据类型之列表操作

    数据类型是一种值的集合以及定义在这种值上的一组操作。这篇文章主要介绍了python内置数据类型之列表的相关知识,非常不错,具有一定的参考借鉴价值,需要的朋友可以参考下
    2018-11-11

最新评论