PyInstaller使用手册：从安装到创建执行文件

"PyInstaller手册，作者William Caban，基于Gordon McMillan的手册，中文翻译由feifan.pub@gmail.com完成，介绍了PyInstaller的基本用法和安装、配置、spec文件创建等关键操作。" PyInstaller是一款强大的Python程序打包工具，能够将Python应用程序转换成独立的可执行文件，使得在没有Python环境的计算机上也能运行。它的主要目标是将Python源代码及其依赖库打包成单独的、易于分发的可执行文件。 **安装PyInstaller** PyInstaller的安装过程相对简单，无需将其安装为Python包。只需将下载的压缩文件解压到任意位置，比如/your/path/to/path/to/pyinstaller/。这个目录下的脚本会自动找到所需资源，因此建议选择一个较浅的目录以方便使用。由于PyInstaller与Python版本相关，因此可能需要针对不同Python版本安装相应的PyInstaller版本，并在切换Python版本后运行`Configure.py`进行配置。 **配置PyInstaller** 在开始打包前，需要配置PyInstaller。在PyInstaller的根目录下运行`Configure.py`，它会将必要的配置信息保存到`config.dat`中。这个步骤是必需的，且应在尝试打包之前执行。 **创建spec文件** spec文件是PyInstaller的配置文件，定义了如何打包Python程序。使用`Makespec.py`脚本可以生成spec文件。在命令行中输入`python Makespec.py [选项] <脚本名字>`，其中选项包括： - `-F` 或 `--onefile`：生成单个文件的可执行文件，所有依赖项都被合并到一起。 - `-D` 或 `--onedir`：（默认）生成包含多个文件的目录结构，每个文件按需加载。 例如，若要为名为`my_script.py`的脚本创建spec文件，命令将是`python Makespec.py -F my_script.py`，这将产生一个`my_script.spec`文件，随后可以使用这个spec文件进行打包。 **使用PyInstaller打包** 生成spec文件后，可以使用`build`或`run`脚本来打包程序。`build`脚本仅构建可执行文件，而`run`脚本则会先构建再运行。运行`pyinstaller my_script.spec`即可开始打包过程，完成后会在指定目录下生成可执行文件。 **Windows COM服务支持** 对于包含Windows COM服务的项目，PyInstaller也提供了支持。在打包时，需要特别注意处理COM组件的注册和反注册，确保服务能在目标系统上正确运行。 PyInstaller为Python开发者提供了一个便捷的工具，使得Python应用程序能够脱离Python环境独立运行，扩大了Python应用的分发范围。通过合理配置和使用，可以将Python程序打包成用户友好的可执行文件。