Pycharm 给 python 程序打包EXE的配置和方法

前言：

Python 语言的设计变得越来越简单，它有很多可以使用的库，所以尤其在人工智能时代，Python语言被广泛应用。但是Python语言和windows系统的兼容性稍微偏弱，如何生成windows可以执行的exe文件。是要一个很复杂的配置过程，本文就会做一个介绍。

本文，通过一个Python YOLOv8项目的打包实践，将pycharm里面如何运用pyinstaller的工具进行项目打包和配置的中级用法进行了说明和实际例子的实践。

---

1 工具介绍

1.1 PyInstaller 

PyInstaller 是一款用于将 Python 脚本打包为独立可执行文件（如 .exe、.app 等）的工具，支持 Windows、macOS 和 Linux 系统。它的核心作用是解决 Python 程序「依赖环境」的问题 —— 打包后生成的可执行文件无需用户安装 Python 解释器或相关库，即可直接运行，极大简化了程序的分发和使用流程。

PyInstaller 是 Python 程序分发的实用工具，通过简单命令即可将脚本打包为独立可执行文件。基础使用只需掌握 --onefile、--add-data 等核心参数；复杂项目可通过 .spec 文件精细配置资源、依赖等，解决打包中的路径、依赖缺失等问题。

一、核心功能与优势

1. 跨平台支持
   可在 Windows（生成 .exe）、macOS（生成 .app）、Linux（生成 ELF 格式可执行文件）上运行，且能为不同系统交叉编译（需特定环境配置）。

2. 两种打包模式

   • 单文件模式（--onefile）：所有依赖（代码、库、资源文件）被压缩到一个独立的可执行文件中，方便传输，但运行时会临时解压到系统临时目录，启动速度略慢。
   • 文件夹模式（默认，--onedir）：生成一个包含可执行文件和所有依赖文件的文件夹，启动速度快，但分发时需整个文件夹传递。

3. 自动处理依赖
   自动分析 Python 脚本中的 import 语句，追踪所有依赖的模块（包括标准库、第三方库）和二进制文件（如 .dll、.so），并打包到最终文件中。

4. 支持资源文件打包
   可通过配置将图片、配置文件（如 .yaml、.json）、数据文件等非代码资源打包到可执行文件中，确保程序运行时能正确读取

二、基本使用流程

2.1.安装
通过 pip 安装：

pip install pyinstaller

2.2.基础打包命令

• 打包单个脚本（默认文件夹模式）：

pyinstaller main.py

• 单文件模式打包：

pyinstaller --onefile main.py

2.3 生成文件说明
执行命令后，会生成以下文件 / 文件夹：

• dist/：存放最终的可执行文件（或文件夹）。
• build/：打包过程中的临时文件（可删除）。
• main.spec：打包配置文件（可手动修改高级配置）。

三、关键参数与配置

PyInstaller 的参数可通过命令行或 .spec 文件配置，常用核心参数如下：

类别	参数 / 配置项	作用说明
打包模式	--onefile	单文件模式，所有内容合并为一个 .exe