PyInstaller 打包python 程序 成 可执行文件

发布于:2025-02-28 ⋅ 阅读:(19) ⋅ 点赞:(0)

pyinstaller --onefile --name my_project --add-data "config/config.json:config" main.py

要将整个 Python 项目打包成一个可执行文件,可以使用 PyInstaller 来完成这个任务。以下是如何将整个项目打包成可执行文件的步骤:

1. 安装 PyInstaller:

确保你已经安装了 PyInstaller,如果没有安装,可以使用以下命令进行安装:

bash

pip install pyinstaller

2. 导航到项目目录:

打开终端或命令提示符,进入你的项目根目录(包含主 Python 脚本的目录)。

3. 运行 PyInstaller 命令:

在项目目录下运行以下命令,将整个项目打包成一个可执行文件:

bash

pyinstaller --onefile --name your_executable_name your_entry_script.py

参数说明:
  • --onefile:将所有依赖项打包成一个单独的可执行文件。

  • --name:生成的可执行文件的名称,你可以指定一个自定义的名字。

  • your_entry_script.py:项目的入口脚本(通常是包含 if __name__ == '__main__': 的脚本)。

例如,如果你的项目入口脚本是 main.py,你可以这样运行:

bash

pyinstaller --onefile --name my_project main.py

4. 处理额外资源(如数据文件、配置文件):

如果你的项目中有需要包含的额外资源文件(比如 JSON、配置文件、图片等),你可以使用 --add-data 参数来将这些文件打包进去。

格式是:

bash

pyinstaller --onefile --name my_project --add-data "path_to_file_or_folder:target_folder_in_dist" main.py

例如:

bash

pyinstaller --onefile --name my_project --add-data "config/config.json:config" main.py

这样会将 config/config.json 文件添加到生成的可执行文件中。

5. 找到生成的可执行文件:

打包完成后,PyInstaller 会生成 dist 文件夹,里面包含生成的可执行文件。

6. 运行可执行文件:

进入 dist 目录,运行生成的可执行文件。

  • 在 Windows 上:

    bash

    dist\your_executable_name.exe

  • 在 Linux/Mac 上:

    bash

    ./dist/your_executable_name

7. 其他常用参数:

  • --icon=icon.ico:为可执行文件设置自定义图标。

  • --hidden-import=module_name:如果有模块未被自动识别,可以手动指定导入。

  • --noconsole:如果你不希望在执行时显示终端窗口(适用于图形界面应用程序),可以使用这个参数。

例子:

假设你的项目结构如下:

bash

my_project/ │ ├── main.py # 项目的入口 ├── utils.py # 辅助模块 ├── config/ │ └── config.json # 配置文件 └── assets/ └── logo.png # 资源文件

你可以使用如下命令将整个项目打包:

bash

pyinstaller --onefile --name my_project_executable --add-data "config/config.json:config" --add-data "assets/logo.png:assets" main.py

打包完成后,你可以在 dist/my_project_executable 目录中找到打包好的可执行文件。

这样,你的整个项目就被打包成了一个可执行文件。


网站公告

今日签到

点亮在社区的每一天
去签到