python工程打包为一个可执行的exe文件

文章目录

• 背景
• 步骤
• • [安装 PyInstaller](#安装 PyInstaller)
  • 打包python脚本
  • 生成的文件
  • 特殊情况
• 示例

---

背景

打包一个Python工程为一个可执行的exe文件，效果是：打包完成之后，这个exe文件在没有python环境的电脑也能运行，不需要安装额外的环境

---

步骤

安装 PyInstaller

需要安装 PyInstaller。可以使用 pip 来安装：

pip install pyinstaller

打包python脚本

代码如下（示例）：

pyinstaller --onefile --icon=myicon.ico main.py

其中：

--icon=<icon_path>：为可执行文件指定一个图标。

--onefile：将所有文件打包成一个独立的可执行文件

生成的文件

PyInstaller 会生成一个 dist 目录，里面包含 main.exe 文件。你可以将这个 main.exe 文件复制到没有 Python 环境的电脑上运行。

只需要复制那个main.exe即可

特殊情况

PyInstaller 会自动检测并包含大部分依赖包，但有时需要手动处理一些特殊的依赖。你可以通过 --hidden-import 选项来手动指定需要的模块。

pyinstaller --onefile --hidden-import <module_name> main.py

示例

假设你的 Python 工程结构如下：

my_project/
│
├── main.py
├── module1.py
└── module2.py

在 my_project 目录下运行：

pyinstaller --onefile main.py

这将在 dist 目录下生成一个 main.exe 文件。