PythonSizeCruncher使用教程

1. 项目介绍

PythonSizeCruncher是一款开源脚本，用于减小由PyInstaller、uitka或Python embeddable构建生成的包的大小。它通过选择性地删除未使用的文件来实现包体积的减小，对于提高软件的部署效率降低存储成本具有重要意义。

2. 项目快速启动

在开始之前，请确保您的系统中已经安装了Python环境。

步骤1：克隆项目

首先，您需要将PythonSizeCruncher项目克隆到本地环境中。打开命令行工具，执行以下命令：

git clone https://github.com/mengdeer589/PythonSizeCruncher.git

步骤2：运行瘦身脚本

进入项目目录，运行main.py脚本。在运行前，请确保您的打包程序正在运行，并且所有功能都已经启动。

cd PythonSizeCruncher
python main.py

脚本会遍历指定目录下的所有文件，检测未被程序占用的文件，并将其移动到_new目录中。

步骤3：检查与恢复

脚本执行完毕后，关闭您的打包程序，检查程序是否能正常运行。如果出现错误提示，可以根据文件移动清单.txt中的记录找到并恢复所需的文件。

3. 应用案例和最佳实践

应用案例

• 减小PyInstaller打包程序的体积：通过PythonSizeCruncher，可将PyInstaller打包的程序的体积减小约50%。
• 优化Nuitka构建的软件包：对于使用uitka构建的程序包，体积可减少约30%。

最佳实践

• 白名单管理：在white_files.json中添加运行程序时必须的文件，以防止这些文件被错误地移动到_new目录。
• 测试环境：在非生产环境中首先执行瘦身操作，确保不会影响到程序的正常运行。

4. 典型生态项目

目前，PythonSizeCruncher主要适用于使用PyInstaller、uitka或Python embeddable进行打包的Python项目。在软件发布和部署阶段，它可以帮助开发者和运维人员优化软件包大小，提升用户体验。

以上就是PythonSizeCruncher的使用教程，希望对您有所帮助。如果您在使用过程中遇到任何问题或想要分享您的经验，欢迎在项目仓库中提出issue或pull request。