Python脚本打包为exe文件

灰太狼 2022-09-22 13:00 238阅读 0赞

把Python脚本和所用到的库打包为exe文件，可以更方便的发布程序，避免使用程序的每个电脑都必须安装Python。  
网上有不少相关介绍，但很少见到Python 3.x下打包Python脚本为exe的成功案例，笔者探索了一下，成功完成了任务，记录下来分享给需要的朋友。欢迎交流。

一、Python 3.1的打包办法

1、下载cx\_Freeze。  
[http://sourceforge.net/projects/cx-freeze/files/][http_sourceforge.net_projects_cx-freeze_files]  
根据自己的系统类型和Python版本下载合适的类型，我下载的是：cx\_Freeze-4.1.2.win32-py3.1.msi。  
这个工具目前最新版本是2010.1.6号的，还挺新的。

2、安装。  
直接安装下载的安装包。

之后可以看到cxfreeze工具所在目录如下：  
![8363385.png][]

![8352589.png][]

3、打包。

我要打包的是BlogPost.py和它依赖的模块。  
A、准备工作。  
a、去除代码中所有中文字符，包括注释。（指定编码的注释可以不去掉没有关系）  
b、如果用到类似lxml这样的第三方库，可能会出现找不到\_elementpath模块的错误。需要在某个.py文件中写上import \_elementpath as DONTUSE，并且指定该模块的搜索路径。（我的该模块所在路径是：C:\\Python25\\Lib\\site-packages\\lxml\\\_elementpath.py）

B、命令行执行。

C:\\Python31\\Scripts\\cxfreeze.bat --include-path=C:\\Python25\\Lib\\site-packages\\lxml --init-script=D:\\Projects\\Google\\pyblogpost\\2exe\\BlogPost.py BlogPost.py  
注意：

（1）--init-script指定的启动文件路径必须用绝对路径，否则会提示找不到init script。

（2）只能指定一个要打包的模块，也就是启动模块。

（3）所有.py文件都不能有中文字符，否则会出现编码异常。

（4）执行上述命令后，在会生成dist目录，里面就有打包后的可执行文件。  
（5）发布后，可执行文件执行路径不能有中文（最好也不要有空格）。而且最好发布dist目录所有文件，我发现有时只发布打包后的exe是无法运行的。  
（6）启动执行的文件中不要有下面这种判断，否则可执行文件执行会没有任何效果。  
if \_\_name\_\_ == "\_\_main\_\_":  
main()

（7）如果没有指定--include-path，或者没有在某个.py文件中写上import \_elementpath as DONTUSE，都会出现如下找不到\_elementpath模块的错误：  
D:\\Projects\\Google\\pyblogpost\\2exe\\dist>BlogPost.exe  
Traceback (most recent call last):  
  File "D:\\Projects\\Google\\pyblogpost\\2exe\\BlogPost.py", line 11, in <module>  
    import BlogConfig  
  File "BlogConfig.py", line 5, in <module>  
  File "ExtensionLoader\_lxml\_etree.py", line 12, in <module>  
  File "lxml.etree.pyx", line 39, in init lxml.etree (src/lxml/lxml.etree.c:1399  
44)  
ImportError: No module named \_elementpath  
（8）不能有中文，即使是注释中也不能有，否则出现如下错误。  
    codeString = fp.read()  
  File "C:\\Python31\\lib\\codecs.py", line 300, in decode  
    (result, consumed) = self.\_buffer\_decode(data, self.errors, final)  
UnicodeDecodeError: 'utf8' codec can't decode bytes in position 557-558: invalid  
 data  
尝试把编码由cp936改为utf-8，也不可以，把文件中ASCII另存为UTF-8,也不行，有如下错误：  
  File "BlogConfig.py", line 1  
    \\ufeff\#!/usr/bin/python  
      ^  
SyntaxError: invalid character in identifier  
  
4、补充说明另外一种打包方式。  
第3点讲的是通过命令行指定参数打包，也可以采用如下方式：  
（1）新建setup.py文件，内容大致如下：（我使用的是上述第3点讲述的方法，没有修改参数）  
（2）在命令行执行：python setup.py build  
这种打包方法，在cxfreeze工具的sample中也大量使用。

二、Python 2.x版本

上面的cx\_Freeze同样提供for Python 2.x的版本，用法我估计也差不多，不再赘述。

加上这一节，是记录一下之前我用Python 2.x写一个小工具用py2exe打包的过程。

先安装py2exe工具。

然后用下面setup.py脚本：   
from distutils.core import setup  
import py2exe  
options = \{"py2exe": \{"bundle\_files": 1\}\}        
setup(options = options,  
      zipfile = None,  
    console=\["hello.py"\],)   
命令行执行：   
C:\\Python26\\python.exe setup.py py2exe   
就会在dist目录生成单一的hello.exe文件，这个文件是可执行的。

[http_sourceforge.net_projects_cx-freeze_files]: http://sourceforge.net/projects/cx-freeze/files/
[8363385.png]: /images/20220721/399c8f4b87ff40a88877f86f9e928a1f.png
[8352589.png]: /images/20220721/846beaf5d31b4549b267c32008ac4353.png