pyinstaller将python程序打包成exe文件

将python代码打包成exe文件可以在不安装python环境的情况下直接运行python代码，譬如自己在自己的电脑上写好了代码，想发给其他人使用，可以用下述方法将python程序打包成exe文件，其他人直接执行exe文件即可使用该程序。

1.安装pyinstaller

CMD打开命令行

pip install pyinstaller

此时如果不行，可能是pip没有添加到环境变量。添加到环境变量的具体方法可参考步骤2中的方法。

2.检查是否安装完成

pyinstaller --version

pyinstaller -v

上述两条命令均为查看版本的命令，如果能正常查看版本号即为安装完成，跳转至步骤3。

*此时可能出现报错。

这也是由于未添加到环境变量所致。添加到环境变量的意思就是该功能/文件在任何路径下都可以访问。这种情况需要找到其路径，并添加到系统变量的path中。

（1）找pyinstaller路径

pip show pyinstaller

然而实际添加到环境变量的路径应该是Scripts。

转到上述红框路径的上一级目录Python312，看到有Scripts文件夹，进入，查看有pyinstaller.exe。只有exe文件才能直接执行。

（2）添加到环境变量

复制Scripts文件夹路径，搜索编辑系统环境变量，打开。

添加之后确定，保存。重启CMD，可以正常查看version，即安装完成。

3 使用pyinstaller打包

最好在虚拟环境下打包，这样可以减少对不必要的库的打包，提升运行速度。

可参考下述文章激活虚拟环境，并安装所需要的库。

VScode的python虚拟环境-CSDN博客

继续在虚拟环境的终端命令行进行打包操作。

pyinstaller -F -p xxxxxxx\.venv\Lib\site-packages main.py

上述xxx表示省略，-F参数代表制作独立的可执行程序，-p表示添加导入路径，即你所安装的库的路径。具体为刚才创建的虚拟环境的.venv文件夹下的路径。根据实际情况将绝对路径写在这里即可。最后的main.py为你想要打包的python文件，可根据实际情况改成自己的文件名。

这步完成后，会生成main.spec文件和dist、build文件夹，其中可执行文件存储在dist文件夹内，直接执行即可。

4 输入输出文件说明

生成结束后，执行main.exe文件时，当前路径在main.exe文件所在的目录下，其实与之前的main.py文件是不同的。

因而如果py程序需要输入或者输出文件的话，最好在编写程序时，就将输入输出文件设置在与main.py同一目录下，这样在生成exe之后，直接将上述输入输出文件移动到exe所在文件夹（即dist文件夹）即可。

最终dist文件夹即为可移植的程序，复制到其他电脑上也可以正常运行。

注：

操作错误说明：

（1）我一开始操作的时候一直用CMD进行打包操作，最终都会出现各种各样的错误，导致main函数执行出错，依赖库无法识别等等，应该是在虚拟环境下进行操作，才能避免上述错误。

（2）注意虚拟环境也需要pip install pyinstaller安装pyinstaller库。

（3）上述所有路径最好都不要有中文，否则可能出现无法识别路径的问题。