python打包之pyinstaller

方法 1：使用 PyInstaller

PyInstaller 是一个流行的工具，可以将 Python 脚本打包为独立的可执行文件。

1.安装 PyInstaller：

1. # 使用pip安装pyinstaller
   
   pip install pyinstaller

2.执行打包命令

在cmd命令行输入如下命令

使用了 --onefile 选项，所有内容会打包成一个单独的可执行文件：

# 在cmd命令行输入如下命令
# 所有文件均生成在一个.exe 文件中

示例格式：pyinstaller --onefile your_script.py

pyinstaller  --onefile "D:/目录/myscript.py"

使用 --add-data 选项，所有内容会打包在一个文件夹下，包含可修改的配置文件以及.exe可执行文件：

# 使用 --add-data 参数

# 使用示例

pyinstaller  --console --add-data "D:/config.json文件目录/config.json;." "D:/录。py文件存放目录/my_script.py"


# ;:分号表示路径分隔符，windows中使用分号，分隔配置文件config.json与存放该文件的目录
# .:分号后的点，目标路径，表示将 config.json 打包到可执行文件的同级目录下

3.示例

假设你的项目结构如下：

my_project/
 ├── your_script.py
 ├── config.ini
 └── images/
         └── logo.png

目标

• 将 config.ini 打包到可执行文件的同级目录。

• 将 logo.png 打包到 images 子目录。

打包命令

在cmd命令行中操作

"""
将config.ini文件存放到与可执行文件同一目录下，
将log.png存放到imgages目录下，将images存放到与可执行文件同意文件夹下
"""
pyinstaller --onefile --add-data "config.ini;." --add-data "images/logo.png;images" your_script.py

打包后的结构

打包后的可执行文件和数据文件会被组织如下：

dist/ 
├── your_script.exe 
├──config.ini 
└── images/ 
        └── logo.png

4.默认输出目录

• 当你运行 pyinstaller 命令时，默认会在当前目录下生成以下文件夹和文件：

  • build/：存放临时文件和日志。

  • dist/：存放生成的可执行文件。

  • your_script.spec：生成的配置文件（用于自定义打包行为）。

  • 5.自定义输出目录

  • 如果你希望将生成的文件存放在指定目录，可以使用 --distpath 和 --workpath 选项

  • pyinstaller --onefile --distpath ./output --workpath ./temp your_script.py

    • --distpath ./output：将生成的可执行文件存放在 output/ 目录。

    • --workpath ./temp：将临时文件存放在 temp/ 目录。

    • ./：表示当前目录，可自定义，在此表示存放.py文件的路径

6. 常用参数

以下是一些常用的 PyInstaller 参数，可以在生成 .spec 文件时使用：

参数	说明
--onefile	将所有内容打包成一个单独的可执行文件。
--onedir	将内容打包到一个目录中（默认行为）。
--name	指定生成的可执行文件名称。
--icon	指定可执行文件的图标（.ico 文件）。
--add-data	添加额外的数据文件（格式：源路径;目标路径）。
--add-binary	添加额外的二进制文件（格式：源路径;目标路径）。
--hidden-import	添加隐藏的依赖模块。
--console	显示控制台窗口（默认行为）。
--windowed	不显示控制台窗口（适用于 GUI 程序）。
--clean	清理临时文件并重新打包。
--distpath	指定生成的可执行文件存放目录。
--workpath	指定临时文件存放目录。

示例：

pyinstaller --onefile --name my_app --icon my_icon.ico --add-data "config.ini;." your_script.py

---

7. 示例：打包带有配置文件的项目

假设你的项目结构如下：

# 目录结构
my_project/
├── your_script.py
├── config.ini
└── my_icon.ico

步骤 1：生成 .spec 文件

bash

复制

pyinstaller your_script.py

步骤 2：修改 .spec 文件

在 your_script.spec 中，修改 datas 部分以包含 config.ini/config.json 文件：

a = Analysis(
    ['your_script.py'],
    pathex=['/path/to/your/project'],
    binaries=[],
    datas=[('config.ini', '.')],  # 添加配置文件
    hiddenimports=[],
    hookspath=[],
    runtime_hooks=[],
    excludes=[],
    win_no_prefer_redirects=False,
    win_private_assemblies=False,
    cipher=block_cipher,
)

步骤 3：使用 .spec 重新打包

pyinstaller your_script.spec

运行可打包的可执行文件

1.在本地运行，一般双击可执行文件（.exe)运行

2.在无对应环境电脑上运行，先检查配置文件是否已设置好，再双击运行 .exe 可执行文件，若双击运行失败且未显示报错信息，则可通过cmd命令行切换到可执行文件目录，在cmd命令行运行该 .exe 文件

示例

input()：用于使代码运行完成后继续显示cmd命令窗口，可查看报错或相关信息

实例代码