PythonSizeCruncher安装与配置指南

1. 项目基础介绍

PythonSizeCruncher 是一个开源脚本，旨在减小由 PyInstaller、Nuitka 或 Python embeddable 构建的 Python 程序的打包体积。它通过在程序运行时识别并删除未被使用的文件来实现这一目标，有效减少打包后程序的大小。

主要编程语言：Python

2. 项目使用的关键技术和框架

• Python：脚本本身使用 Python 编写，用于遍历文件并检查其使用状态。
• 操作系统文件锁定机制：通过检测文件是否被操作系统锁定来判断文件是否正在被使用。

3. 项目安装和配置的准备工作及详细步骤

准备工作

• 确保你的系统中已安装 Python。PythonSizeCruncher 支持的 Python 版本在项目描述中会有明确说明。
• 准备一个由 PyInstaller、Nuitka 或 Python embeddable 打包的 Python 程序。

安装步骤

1. 克隆项目到本地

   打开命令行窗口，使用以下命令克隆项目：

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

   这会在当前目录下创建一个名为 PythonSizeCruncher 的文件夹。

2. 运行打包好的程序

   打开你的打包程序，确保程序的所有功能都处于开启状态。

3. 运行 PythonSizeCruncher 脚本

   在另一个命令行窗口中，切换到 PythonSizeCruncher 文件夹，并运行以下命令：

   python main.py
   

   脚本将自动遍历指定目录下的所有文件，并将未使用的文件移动到 _new 目录中。

4. 检查与恢复

   完成文件移动后，关闭你的打包程序，然后再次运行。如果遇到缺少文件的提示，可以查看 _new 目录中的文件，并根据需要恢复。

5. 调整白名单

   如果脚本错误地标记了必要的文件，请将这些文件添加到 white_files.json 中，以防止它们被移动。

通过以上步骤，你可以使用 PythonSizeCruncher 来减小你的 Python 打包程序的大小。记住，在调整白名单时要格外小心，以确保不删除重要的文件。