使用 Python 打包项目及其依赖环境是将开发的应用程序部署到其他机器上运行的关键步骤。以下是几种常见的打包方式，包括基于不同工具的实践方法： ### 使用 `soeasypack` 简易打包 `soeasypack` 是一个自动化监控文件访问记录并精准匹配依赖的工具，它能实现高效的最小体积打包。该工具通过微软的 Procmon（进程监控）技术，动态分析项目运行时所需的文件，并自动生成一个由 Go 编写的外壳 `.exe` 文件作为启动入口。 打包过程中会自动将 `.py` 文件转换为 `.pyc` 文件以减少暴露源代码的风险。用户应确保在打包前尽可能运行项目的全部功能，以便工具能够完整地捕获所有依赖项[^1]。 示例代码如下： ```python from soeasypack import to_pack save_dir = r'C:\save_dir' main_py_path = r'C:\my_project\main.py' exe_name = '大都督' to_pack(main_py_path, save_dir, pack_mode=0, embed_exe=False, exe_name=exe_name, pyc_optimize=1, except_packages=['numpy']) ``` ### 使用 `PyInstaller` 打包 `PyInstaller` 是另一个广泛使用的打包工具，支持将 Python 脚本转换为独立的可执行文件。其优点是可以跨平台使用（Windows、Linux、macOS），并且可以嵌入资源文件如图标、配置文件等。 首先需要安装 `PyInstaller`： ```bash pip install pyinstaller ``` 然后可以通过以下命令进行打包： ```bash pyinstaller --onefile your_script.py ``` 如果项目包含额外的依赖文件（如图片、配置文件等），建议将其与主脚本放在同一目录中，并在打包时通过 `--add-data` 参数指定这些文件路径。 ### 使用 `setuptools` 和 `wheel` 进行分发打包 若目标是将项目发布为可安装的 Python 包，则可以使用 `setuptools` 和 `wheel`。这种方式适合用于内部部署或上传至 PyPI 供他人下载安装。 首先需要编写 `setup.py` 文件，定义项目名称、版本、依赖等信息。例如： ```python from setuptools import setup, find_packages setup( name='your_package', version='0.1', packages=find_packages(), install_requires=[ 'requests', 'numpy', ], ) ``` 随后，运行以下命令生成 `.whl` 文件： ```bash python setup.py bdist_wheel ``` ### 导出依赖列表 `requirements.txt` 为了确保目标环境中存在正确的依赖库，可以使用 `pipreqs` 或 `pip freeze` 来导出依赖列表。其中，`pipreqs` 更加智能，仅提取当前项目实际用到的库： ```bash pip install pipreqs pipreqs /path/to/your/project ``` 这将在项目目录下生成一个 `requirements.txt` 文件，之后可通过以下命令安装依赖： ```bash pip install -r requirements.txt ``` ### 注意事项 - **依赖路径**：确保项目中对依赖文件的引用使用相对路径，避免因绝对路径导致的问题[^3]。 - **测试打包结果**：打包完成后，应在另一台没有开发环境的机器上测试可执行文件是否正常工作。 - **排除不必要的依赖**：在某些情况下，可能希望排除特定的大体积库（如 `numpy`），以减小最终打包体积。 ---